Neon Pilot CLI Reference

<!-- Generated by scripts/generate-cli-reference.mjs. Do not edit by hand. -->

Generated from neon-pilot commands --json with 91 commands.

app update

Update the packaged Neon Pilot app from the signed GitHub release installer.

• Source: extension (system-neon-pilot-admin-cli)
• Usage: neon-pilot app update [--channel stable|rc] [--app-dir /Applications] [--repo owner/name] [--dry-run] [--json]
• Mode: write
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot app update --json
• neon-pilot app update --channel rc --json
• neon-pilot app update --dry-run --json

app-commands list

List command-palette/app commands available to extensions. Advanced escape hatch; prefer first-class CLI commands when available.

• Source: extension (system-neon-pilot-admin-cli)
• Usage: neon-pilot app-commands list [--json]
• Mode: read
• Requires app: yes
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot app-commands list
• neon-pilot app-commands list --json

app-commands run

Run a command-palette/app command by id. Advanced escape hatch; prefer first-class CLI commands when available.

• Source: extension (system-neon-pilot-admin-cli)
• Usage: neon-pilot app-commands run <commandId> [args...] [--args <json>] [--json]
• Mode: write
• Requires app: yes
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot app-commands run cmd-1
• neon-pilot app-commands run cmd-1 --args '{"value":1}' --json

ask

Create a conversation, run one turn, and print the result.

• Source: extension (system-conversation-tools)
• Usage: neon-pilot ask [prompt...] [--text <prompt>] [--prompt <prompt>] [--title <title>] [--cwd <path>] [--model <provider/model>] [--thinking-level <level>] [--service-tier <tier>] [--tool <name>] [--tools <names>] [--timeout-ms <ms>] [--follow] [--format <text|json|jsonl>] [--cancel-on-interrupt] [--json]
• Mode: streaming
• Requires app: yes
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json, jsonl

Examples:

• neon-pilot ask --model opencode-go/deepseek-v4-flash --cwd /repo "Summarize the diff"
• neon-pilot ask --text "Reply with ready" --json

background-commands cancel

Cancel a background command: background-commands cancel <run-id>.

• Source: extension (system-runs)
• Usage: neon-pilot background-commands cancel <id> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot background-commands cancel example-id
• neon-pilot background-commands cancel example-id --json

background-commands get

Inspect a background command: background-commands get <run-id>.

• Source: extension (system-runs)
• Usage: neon-pilot background-commands get <id> [--json]
• Mode: read
• Requires app: yes
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot background-commands get example-id
• neon-pilot background-commands get example-id --json

background-commands list

List durable background commands.

• Source: extension (system-runs)
• Usage: neon-pilot background-commands list [--json]
• Mode: read
• Requires app: yes
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot background-commands list
• neon-pilot background-commands list --json

background-commands logs

Read background command logs: background-commands logs <run-id> [--tail <n>]

• Source: extension (system-runs)
• Usage: neon-pilot background-commands logs <id> [--tail <n>] [--json]
• Mode: read
• Requires app: yes
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot background-commands logs example-id
• neon-pilot background-commands logs example-id --tail 200
• neon-pilot background-commands logs example-id --json

background-commands rerun

Rerun a background command: background-commands rerun <run-id>.

• Source: extension (system-runs)
• Usage: neon-pilot background-commands rerun <id> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot background-commands rerun example-id
• neon-pilot background-commands rerun example-id --json

background-commands start

Start a durable background command: background-commands start --command <shell> [--cwd <path>]

• Source: extension (system-runs)
• Usage: neon-pilot background-commands start --command <shell> [--cwd <path>] [--json]
• Mode: background
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot background-commands start --command echo ok
• neon-pilot background-commands start --command echo ok --json

bootstrap configure

Configure Neon Pilot defaults and external-agent entrypoints.

• Source: extension (system-neon-pilot-admin-cli)
• Usage: neon-pilot bootstrap configure [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot bootstrap configure
• neon-pilot bootstrap configure --json

bootstrap defaults set

Set default provider, model, cwd, thinking level, and service tier.

• Source: extension (system-neon-pilot-admin-cli)
• Usage: neon-pilot bootstrap defaults set [--json]
• Mode: write
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot bootstrap defaults set
• neon-pilot bootstrap defaults set --json

bootstrap doctor

Check whether Neon Pilot is ready for external agent control.

• Source: extension (system-neon-pilot-admin-cli)
• Usage: neon-pilot bootstrap doctor [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot bootstrap doctor
• neon-pilot bootstrap doctor --json

bootstrap provider model

Create or update a provider model definition.

• Source: extension (system-neon-pilot-admin-cli)
• Usage: neon-pilot bootstrap provider model <provider> <modelId> [--context-window <tokens>] [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot bootstrap provider model openai gpt-5.4 --context-window 200000
• neon-pilot bootstrap provider model openai gpt-5.4 --context-window 200000 --json

bootstrap provider save

Create or update a model provider definition.

• Source: extension (system-neon-pilot-admin-cli)
• Usage: neon-pilot bootstrap provider save <provider> [--base-url <url>] [--api <api>] [--json]
• Mode: write
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot bootstrap provider save openai --api openai
• neon-pilot bootstrap provider save openai --api openai --json

bootstrap provider set-key

Store a provider API key through the configured secrets backend. Use --stdin.

• Source: extension (system-neon-pilot-admin-cli)
• Usage: neon-pilot bootstrap provider set-key <provider> --stdin [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot bootstrap provider set-key openai --stdin
• neon-pilot bootstrap provider set-key openai --stdin --json

cli install

Install the optional user-shell neon-pilot symlink.

• Source: core
• Usage: neon-pilot cli install [--json]
• Mode: write
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot cli install

cli status

Show the channel-local launcher and optional user-shell link status.

• Source: core
• Usage: neon-pilot cli status [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json
• Aliases: cli

Examples:

• neon-pilot cli status
• neon-pilot cli status --json

cli uninstall

Remove the optional Neon Pilot-owned user-shell symlink.

• Source: core
• Usage: neon-pilot cli uninstall [--json]
• Mode: write
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot cli uninstall

commands

List core and enabled extension CLI commands.

• Source: core
• Usage: neon-pilot commands [--brief] [--verbose] [--json] [--quiet] [--no-color]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json
• Aliases: ls

Examples:

• neon-pilot commands
• neon-pilot commands --brief
• neon-pilot commands --verbose

control-plane doctor

Run control-plane smoke checks for commands, conversations, retention dry-run, runtime, and extension storage.

• Source: extension (system-neon-pilot-admin-cli)
• Usage: neon-pilot control-plane doctor [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot control-plane doctor
• neon-pilot control-plane doctor --json

conversations abort

Abort a live conversation turn.

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations abort <conversationId> [--json]
• Mode: write
• Requires app: yes
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations abort conversation-example
• neon-pilot conversations abort conversation-example --json

conversations activity

List backend conversation activity shelf items for a thread.

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations activity <conversationId> [--active] [--visibility primary|system|hidden|visible|all] [--json]
• Mode: read
• Requires app: yes
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot conversations activity conversation-example --json
• neon-pilot conversations activity conversation-example --active --visibility primary --json

conversations archive

Archive conversations by hiding them from normal sidebar/history views: conversations archive <id...>

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations archive <conversationId> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations archive conversation-example
• neon-pilot conversations archive conversation-example --json

conversations compact

Compact a conversation transcript.

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations compact <conversationId> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations compact conversation-example
• neon-pilot conversations compact conversation-example --json

conversations connections

List meaningful things connected to a conversation.

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations connections <conversationId> [--kind activity|state|asset|context|integration|surface|all] [--surface activityShelf|composerShelf|rightRail|workbench|sidebar|cli|all] [--active] [--visibility primary|system|hidden|visible|all] [--json]
• Mode: read
• Requires app: yes
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot conversations connections conversation-example --json
• neon-pilot conversations connections conversation-example --kind state --json

conversations create

Create a conversation with optional title, cwd, model, and startup settings.

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations create [title...] [--title <title>] [--cwd <path>] [--model <provider/model>] [--live] [--initial-prompt <text>] [--prompt <text>] [--thinking-level <level>] [--service-tier <tier>] [--tool <name>] [--tools <names>] [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations create Planning Thread
• neon-pilot conversations create --title "Planning Thread" --cwd /repo --model opencode-go/deepseek-v4-flash --json

conversations cwd

Change a conversation working directory: conversations cwd <id> <path>.

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations cwd <conversationId> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations cwd conversation-example
• neon-pilot conversations cwd conversation-example --json

conversations delete

Permanently delete persisted conversations and remove workspace/sidebar references: conversations delete <id...>

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations delete <id> [--json]
• Mode: destructive
• Requires app: no
• Idempotent: no
• Destructive: yes
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations delete example-id
• neon-pilot conversations delete example-id --json

conversations ensure-live

Ensure a conversation has a live runtime: conversations ensure-live <id> [--cwd <path>]

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations ensure-live <conversationId> [--json]
• Mode: write
• Requires app: yes
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations ensure-live conversation-example
• neon-pilot conversations ensure-live conversation-example --json

conversations fork

Fork a conversation: conversations fork <id> [--title <title>] [--target-cwd <path>]

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations fork <conversationId> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations fork conversation-example
• neon-pilot conversations fork conversation-example --json

conversations inspect

Inspect a conversation by id; optional second arg is outline, query, diff, or read_window.

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations inspect <conversationId> [outline|query|diff|read_window|transcript] [--limit <n>] [--order asc|desc] [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot conversations inspect conversation-example
• neon-pilot conversations inspect conversation-example transcript --limit 20
• neon-pilot conversations inspect conversation-example --json

conversations list

List conversations, optionally filtered by query.

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations list [query...] [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot conversations list
• neon-pilot conversations list planning
• neon-pilot conversations list --json

conversations open active

Set or clear the active sidebar conversation: conversations open active [id]

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations open active [conversationId] [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations open active
• neon-pilot conversations open active conversation-example
• neon-pilot conversations open active conversation-example --json

conversations open add

Add conversations to the open/sidebar list: conversations open add <id...>

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations open add <conversationId> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations open add conversation-example
• neon-pilot conversations open add conversation-example --json

conversations open list

List conversations currently open in the sidebar.

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations open list [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot conversations open list
• neon-pilot conversations open list --json

conversations open pin

Pin conversations in the sidebar: conversations open pin <id...>

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations open pin <conversationId> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations open pin conversation-example
• neon-pilot conversations open pin conversation-example --json

conversations open remove

Remove conversations from open/sidebar state: conversations open remove <id...>

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations open remove <conversationId> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations open remove conversation-example
• neon-pilot conversations open remove conversation-example --json

conversations open unpin

Unpin conversations in the sidebar: conversations open unpin <id...>

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations open unpin <conversationId> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations open unpin conversation-example
• neon-pilot conversations open unpin conversation-example --json

conversations retention prune

Prune old persisted conversations: conversations retention prune --older-than 90d --archived-only --dry-run

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations retention prune [olderThan] [--older-than <duration>] [--archived-only] [--dry-run] [--json]
• Mode: destructive
• Requires app: no
• Idempotent: no
• Destructive: yes
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations retention prune 90d --dry-run
• neon-pilot conversations retention prune --older-than 90d --archived-only --json

conversations rollback

Rollback recent conversation transcript blocks: conversations rollback <id> [count]

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations rollback <conversationId> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations rollback conversation-example
• neon-pilot conversations rollback conversation-example --json

conversations run-turn

Run a conversation turn and wait for completion: conversations run-turn <id> --text <message> [--timeout-ms <ms>]

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations run-turn <conversationId> --text <message> [--timeout-ms <ms>] [--follow] [--format text|json|jsonl] [--cancel-on-interrupt] [--json]
• Mode: streaming
• Requires app: yes
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json, jsonl

Examples:

• neon-pilot conversations run-turn conversation-example --text Hello
• neon-pilot conversations run-turn conversation-example --text Hello --json

conversations scratchpad get

Get a conversation scratchpad: conversations scratchpad get <id>

• Source: extension (system-scratchpad)
• Usage: neon-pilot conversations scratchpad get <id> [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot conversations scratchpad get example-id
• neon-pilot conversations scratchpad get example-id --json

conversations scratchpad patch

Append/prepend to a scratchpad: conversations scratchpad patch <id> --operation append --content <markdown>

• Source: extension (system-scratchpad)
• Usage: neon-pilot conversations scratchpad patch <conversationId> [--operation append|prepend] [--content <markdown>] [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations scratchpad patch conversation-example --operation append --content "Validation passed"
• neon-pilot conversations scratchpad patch conversation-example --json

conversations scratchpad set

Replace a conversation scratchpad: conversations scratchpad set <id> --content <markdown>

• Source: extension (system-scratchpad)
• Usage: neon-pilot conversations scratchpad set <conversationId> [--content <markdown>] [--json]
• Mode: write
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations scratchpad set conversation-example --content "## Plan"
• neon-pilot conversations scratchpad set conversation-example --json

conversations search

Search visible conversation transcript text.

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations search [query...] [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot conversations search planning notes
• neon-pilot conversations search --json

conversations send

Send a message to a conversation: conversations send <id> --text <message> [--steer]

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations send <conversationId> [--json]
• Mode: write
• Requires app: yes
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations send conversation-example
• neon-pilot conversations send conversation-example --json

conversations title

Set a conversation title: conversations title <id> <title>.

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations title <conversationId> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations title conversation-example
• neon-pilot conversations title conversation-example --json

conversations tools

Set active tools for a conversation: conversations tools <id> <tool...>

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations tools <conversationId> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations tools conversation-example
• neon-pilot conversations tools conversation-example --json

conversations transcript append

Append a transcript block. Advanced recovery/admin command; prefer normal conversation turns when possible.

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations transcript append <conversationId> [type] [--type <type>] [--data <json>] [--block-id <id>] [--title <title>] [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations transcript append conversation-example note --data '{"text":"Note"}'
• neon-pilot conversations transcript append conversation-example --type note --data '{"text":"Note"}' --json

conversations transcript read

Read visible transcript blocks for a conversation.

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations transcript read <conversationId> [--limit <n>] [--order asc|desc] [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot conversations transcript read conversation-example
• neon-pilot conversations transcript read conversation-example --limit 20 --json

conversations transcript update

Update a transcript block. Advanced recovery/admin command; inspect first and prefer safer conversation operations when possible.

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations transcript update <conversationId> <blockId> [type] [--type <type>] [--data <json>] [--block-id <id>] [--title <title>] [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations transcript update conversation-example block-1 note --data '{"text":"Updated"}'
• neon-pilot conversations transcript update conversation-example block-1 --type note --data '{"text":"Updated"}' --json

conversations unarchive

Unarchive conversations: conversations unarchive <id...>

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations unarchive <conversationId> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations unarchive conversation-example
• neon-pilot conversations unarchive conversation-example --json

conversations workspace

Read conversation workspace state.

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations workspace [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot conversations workspace
• neon-pilot conversations workspace --json

conversations workspace update

Update open/sidebar workspace state with --open, --pinned, --archived, --active, --workspace-path, or --remote-controlled.

• Source: extension (system-conversation-tools)
• Usage: neon-pilot conversations workspace update [--open <ids>] [--pinned <ids>] [--archived <ids>] [--active <id>] [--workspace-path <path>] [--remote-controlled <ids>] [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot conversations workspace update --open conv-a,conv-b --active conv-b
• neon-pilot conversations workspace update --open conv-a,conv-b --active conv-b --json

doctor

Check CLI launcher, app connection, and runtime path readiness.

• Source: core
• Usage: neon-pilot doctor [--json] [--verbose]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json
• Aliases: runtime doctor

Examples:

• neon-pilot doctor
• neon-pilot doctor --json

extensions catalog

List installable extension catalog entries.

• Source: extension (system-extension-manager)
• Usage: neon-pilot extensions catalog [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot extensions catalog
• neon-pilot extensions catalog --json

extensions create

Create a runtime extension: extensions create <id> --name <name> [--template <template>]

• Source: extension (system-extension-manager)
• Usage: neon-pilot extensions create <extensionId> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot extensions create system-settings
• neon-pilot extensions create system-settings --json

extensions delete

Delete a runtime extension by id. System extensions cannot be deleted.

• Source: extension (system-extension-manager)
• Usage: neon-pilot extensions delete <id> [--json]
• Mode: destructive
• Requires app: no
• Idempotent: no
• Destructive: yes
• Dry run: yes
• Output: text, json
• Aliases: extensions uninstall

Examples:

• neon-pilot extensions delete example-id
• neon-pilot extensions delete example-id --json

extensions disable

Disable an installed extension.

• Source: extension (system-extension-manager)
• Usage: neon-pilot extensions disable <extensionId> [--json]
• Mode: write
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot extensions disable system-settings
• neon-pilot extensions disable system-settings --json

extensions enable

Enable an installed extension.

• Source: extension (system-extension-manager)
• Usage: neon-pilot extensions enable <extensionId> [--json]
• Mode: write
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot extensions enable system-settings
• neon-pilot extensions enable system-settings --json

extensions install

Install an extension from the catalog: extensions install <id>

• Source: extension (system-extension-manager)
• Usage: neon-pilot extensions install <extensionId> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot extensions install system-settings
• neon-pilot extensions install system-settings --json

extensions install-marketplace

Install a marketplace behavior package as an extension: extensions install-marketplace <source> --type skill|instruction-pack|agent|template

• Source: extension (system-extension-manager)
• Usage: neon-pilot extensions install-marketplace <source> --type <skill|instruction-pack|agent|template> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot extensions install-marketplace /path/to/skill --type skill
• neon-pilot extensions install-marketplace /path/to/skill --type skill --json

extensions install-url

Install an extension bundle from URL: extensions install-url <url> [--expected-id <id>]

• Source: extension (system-extension-manager)
• Usage: neon-pilot extensions install-url <url> [--expected-id <id>] [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot extensions install-url https://example.com/system-example.neon-extension.zip
• neon-pilot extensions install-url https://example.com/system-example.neon-extension.zip --expected-id system-example --json

extensions list

List installed Neon Pilot extensions.

• Source: extension (system-extension-manager)
• Usage: neon-pilot extensions list [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot extensions list
• neon-pilot extensions list --json

extensions paths

Read extension search paths.

• Source: extension (system-extension-manager)
• Usage: neon-pilot extensions paths [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot extensions paths
• neon-pilot extensions paths --json

extensions reload

Reload an extension backend by id, or refresh registry state.

• Source: extension (system-extension-manager)
• Usage: neon-pilot extensions reload [extensionId] [--json]
• Mode: write
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot extensions reload
• neon-pilot extensions reload system-settings
• neon-pilot extensions reload --json

extensions smoke

Run backend smoke checks for an installed extension.

• Source: extension (system-extension-manager)
• Usage: neon-pilot extensions smoke <extensionId> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot extensions smoke system-settings
• neon-pilot extensions smoke system-settings --json

extensions snapshot

Snapshot a runtime extension by id.

• Source: extension (system-extension-manager)
• Usage: neon-pilot extensions snapshot <extensionId> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot extensions snapshot system-settings
• neon-pilot extensions snapshot system-settings --json

extensions sources

Read extension catalog sources.

• Source: extension (system-extension-manager)
• Usage: neon-pilot extensions sources [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot extensions sources
• neon-pilot extensions sources --json

extensions update

Update a catalog-installed extension: extensions update <id>

• Source: extension (system-extension-manager)
• Usage: neon-pilot extensions update <extensionId> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot extensions update system-settings
• neon-pilot extensions update system-settings --json

extensions validate

Validate an installed extension by id.

• Source: extension (system-extension-manager)
• Usage: neon-pilot extensions validate <extensionId> [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot extensions validate system-settings
• neon-pilot extensions validate system-settings --json

heartbeats list

List recurring conversation heartbeats.

• Source: extension (system-neon-pilot-admin-cli)
• Usage: neon-pilot heartbeats list [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot heartbeats list
• neon-pilot heartbeats list --json

heartbeats start

Start a recurring conversation heartbeat: heartbeats start <id> --interval-minutes <n> --conversation-id <id> --prompt <prompt>.

• Source: extension (system-neon-pilot-admin-cli)
• Usage: neon-pilot heartbeats start <id> --interval-minutes <n> --conversation-id <id> --prompt <prompt> [--json]
• Mode: background
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot heartbeats start hb-1 --interval-minutes 5 --conversation-id conv-1 --prompt "Check work."
• neon-pilot heartbeats start hb-1 --interval-minutes 5 --conversation-id conv-1 --prompt "Check work." --json

heartbeats stop

Stop a recurring conversation heartbeat: heartbeats stop <id>.

• Source: extension (system-neon-pilot-admin-cli)
• Usage: neon-pilot heartbeats stop <id> [--json]
• Mode: write
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot heartbeats stop example-id
• neon-pilot heartbeats stop example-id --json

help

Show general help or help for a specific command.

• Source: core
• Usage: neon-pilot help [command] [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json
• Aliases: --help, -h, ?

Examples:

• neon-pilot help
• neon-pilot help settings list

paths

Show local Neon Pilot runtime paths used by the CLI.

• Source: core
• Usage: neon-pilot paths [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json
• Aliases: runtime paths

Examples:

• neon-pilot paths
• neon-pilot paths --json

protocol

Invoke a raw extension protocol entrypoint. Advanced integration surface; prefer first-class CLI commands for normal automation.

• Source: core
• Usage: neon-pilot protocol <protocol-id> [args]
• Mode: streaming
• Requires app: yes
• Idempotent: no
• Destructive: no
• Dry run: no
• Output: text

Examples:

• neon-pilot protocol acp
• neon-pilot protocol ds4-tools tools

schema

Export machine-readable CLI command contracts.

• Source: core
• Usage: neon-pilot schema [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: json
• Aliases: commands schema

Examples:

• neon-pilot schema --json

settings get

Read a single setting by key.

• Source: extension (system-settings)
• Usage: neon-pilot settings get <key> [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot settings get conversation.pinnedToolCalls
• neon-pilot settings get conversation.pinnedToolCalls --json

settings list

List merged Neon Pilot settings, optionally filtered by key prefix.

• Source: extension (system-settings)
• Usage: neon-pilot settings list [prefix] [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot settings list
• neon-pilot settings list conversation
• neon-pilot settings list --json

settings reset

Reset one or more settings to manifest defaults: settings reset <key...>

• Source: extension (system-settings)
• Usage: neon-pilot settings reset <key> [--json]
• Mode: write
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot settings reset conversation.pinnedToolCalls
• neon-pilot settings reset conversation.pinnedToolCalls --json

settings schema

List manifest-declared settings schema.

• Source: extension (system-settings)
• Usage: neon-pilot settings schema [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot settings schema
• neon-pilot settings schema --json

settings set

Update a manifest-declared non-secret setting by key and JSON value.

• Source: extension (system-settings)
• Usage: neon-pilot settings set <key> <value> [--json]
• Mode: write
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot settings set conversation.pinnedToolCalls false
• neon-pilot settings set conversation.pinnedToolCalls false --json

tasks delete

Delete a scheduled task: tasks delete <task-id>.

• Source: extension (system-automations)
• Usage: neon-pilot tasks delete <id> [--json]
• Mode: destructive
• Requires app: no
• Idempotent: no
• Destructive: yes
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot tasks delete example-id
• neon-pilot tasks delete example-id --json

tasks get

Inspect a scheduled task: tasks get <task-id>.

• Source: extension (system-automations)
• Usage: neon-pilot tasks get <id> [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot tasks get example-id
• neon-pilot tasks get example-id --json

tasks list

List scheduled tasks.

• Source: extension (system-automations)
• Usage: neon-pilot tasks list [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot tasks list
• neon-pilot tasks list --json

tasks run

Run a scheduled task immediately: tasks run <task-id>.

• Source: extension (system-automations)
• Usage: neon-pilot tasks run <id> [--json]
• Mode: background
• Requires app: no
• Idempotent: no
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot tasks run daily-check
• neon-pilot tasks run daily-check --json

tasks save

Create or update a scheduled task: tasks save <task-id> --title <title> --prompt <prompt> [--cron <expr>|--at <iso>]

• Source: extension (system-automations)
• Usage: neon-pilot tasks save <id> [--json]
• Mode: write
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: yes
• Output: text, json

Examples:

• neon-pilot tasks save daily-check --prompt "Check status" --cron "0 9 * * *"
• neon-pilot tasks save daily-check --prompt "Check status" --cron "0 9 * * *" --json

tasks validate

Validate scheduled tasks, or one scheduled task by id.

• Source: extension (system-automations)
• Usage: neon-pilot tasks validate [id] [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json

Examples:

• neon-pilot tasks validate
• neon-pilot tasks validate daily-check
• neon-pilot tasks validate --json

version

Show Neon Pilot CLI package and runtime channel version information.

• Source: core
• Usage: neon-pilot version [--json]
• Mode: read
• Requires app: no
• Idempotent: yes
• Destructive: no
• Dry run: no
• Output: text, json
• Aliases: --version, -v

Examples:

• neon-pilot version
• neon-pilot version --json

Edit this page on GitHub →