Nethür CLI overview
Use the Nethür CLI to script Nethür from a terminal, manage worktrees, control agent terminals, automate the built-in browser, and install agent skills.
The Nethür CLI is the nethur command-line interface for scripting a running Nethür editor from any shell. Use it to create and inspect worktrees, drive agent terminals, open files and diffs, automate the built-in browser, run scheduled automations, share HTML/Markdown artifacts, and control Nethür-native tools from scripts or AI agents.
It ships with the desktop app; register it under Settings → General → Nethür CLI. On Linux the command is nethur-ide, because GNOME Nethür's screen reader already owns /usr/bin/nethur — see Install → Linux.
Agents can install the matching Nethür CLI skill with:
nethur skills install --skill nethur-cli
# headless / no Settings UI:
nethur skills install --skill nethur-cliSee Skills registry & MCP for every installable Nethür skill, including nethur skills install / nethur skills update.
Install & verify
command -v nethur
nethur status --jsonWorktree commands
nethur worktree ps --json
nethur worktree create --repo id:<repoId> --name my-task --issue 123 --json
nethur worktree create --repo id:<repoId> --name review-pr-123 --pr 123 --json
nethur worktree current --json
nethur worktree set --worktree active --comment "reproduced bug" --json
nethur worktree set --worktree active --gitlab-issue 42 --gitlab-mr 77 --json
nethur worktree set --worktree active --pr null --json
nethur worktree rm --worktree id:<id> --force --jsonFor selectors, setup flags, parent/child worktrees, and the broader command map, see Nethür CLI reference.
Terminal commands
nethur terminal list --json
nethur terminal read --json
nethur terminal send --text "continue" --enter --json
nethur terminal wait --for tui-idle --timeout-ms 30000 --json
nethur terminal create --worktree path:/projects/app --command "npm test" --json
nethur terminal split --direction vertical --command "npm run dev" --jsonFor tracked multi-agent work, use Orchestration instead of plain terminal prompts.
File commands
Open files and diffs as tabs in their Nethür worktree from a shell. They open without changing what you are looking at; add --focus to be brought to the file:
nethur file open src/App.tsx
nethur file diff src/App.tsx --staged
nethur file open-changed --mode bothUse --worktree <selector> when the shell's current directory is not inside the target worktree.
Browser profiles
Browser profiles isolate tab session state, so a script or agent can test with different cookies, local storage, and logged-in identities. The CLI exposes profile commands under nethur tab profile; start with nethur tab profile list --json, then use create, set, clone, or use-default as needed.
Scheduled automations
Use nethur automations to create, inspect, run, and remove scheduled Nethür tasks from a shell. Start with Scheduled automations when you want a recurring prompt to run against a repo or an existing worktree.
Artifacts
Share HTML or Markdown as public view links through the signed-in Nethür account (nethur artifacts share|update|list|delete). Publishing is opt-in under Settings → Artifacts. Command details: CLI reference → Artifacts.
Browser automation
The CLI also drives the built-in browser with a snapshot-interact-re-snapshot loop:
nethur goto --url https://example.com --json
nethur snapshot --json # returns refs like @e1, @e3
nethur click --element @e3 --json
nethur fill --element @e1 --value "[email protected]" --json
nethur screenshot --jsonFor responsive browser checks, switch the active tab to a named device profile:
nethur set device --name "iPhone 12" --json
nethur screenshot --jsonMobile emulator
The CLI can also drive an iOS Simulator through Nethür's mobile emulator bridge. It is scoped to the active worktree, so agents and scripts can attach a simulator from nethur emulator list, tap normalized coordinates, type text, send gestures, rotate the device, and shut it down without leaving Nethür.
nethur emulator list --json
nethur emulator attach "<device-name-or-udid>" --json
nethur emulator tap 0.5 0.7 --json
nethur emulator type "hello" --json
nethur emulator gesture '[{"type":"begin","x":0.5,"y":0.8},{"type":"move","x":0.5,"y":0.4},{"type":"end","x":0.5,"y":0.2}]' --json
nethur emulator rotate landscape_left --json
nethur emulator kill --jsonUse --worktree <selector>, --device <udid-or-name>, or --emulator <id> when a script needs an explicit target.