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:

bash
nethur skills install --skill nethur-cli
# headless / no Settings UI:
nethur skills install --skill nethur-cli

See Skills registry & MCP for every installable Nethür skill, including nethur skills install / nethur skills update.

Install & verify

command -v nethur
nethur status --json

Worktree commands

shell
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 --json

For selectors, setup flags, parent/child worktrees, and the broader command map, see Nethür CLI reference.

Terminal commands

shell
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" --json

For 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:

shell
nethur file open src/App.tsx
nethur file diff src/App.tsx --staged
nethur file open-changed --mode both

Use --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:

shell
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 --json

For responsive browser checks, switch the active tab to a named device profile:

shell
nethur set device --name "iPhone 12" --json
nethur screenshot --json

Mobile 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.

shell
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 --json

Use --worktree <selector>, --device <udid-or-name>, or --emulator <id> when a script needs an explicit target.