CLI
Documentation

Version Latest

Editors

Use the CLI's agent from Zed and other Agent Client Protocol editors, or from VS Code with its extension, with the same settings, rules and sessions as the terminal.

The CLI's agent can run inside other editors. Whichever way it runs, permission rules, hooks, the sandbox, the audit log and managed policy apply exactly as in the terminal.

EditorHowProtocol
Zed and other ACP clientsThe editor starts neuralinverse acpAgent Client Protocol over standard input and output
VS CodeThe Neural Inverse extension runs neuralinverse serve locallyThe CLI's HTTP API
A governing host, such as the Editor's shared agent hostThe host starts neuralinverse hostThe NI Host Protocol; see SDK, server and embedding

The Neural Inverse Editor and Agents app have their own agents; see the Editor and the Agents app.

Zed

Add an agent server to Zed's settings.json:

{
  "agent_servers": {
    "Neural Inverse": {
      "command": "neuralinverse",
      "args": ["acp"],
      "env": {}
    }
  }
}

Open the Agent panel, start a new thread and pick Neural Inverse. Global flags work in args, for example ["acp", "--model", "openai/gpt-5", "--mode", "auto-edit"]. Provider keys come from the environment Zed was started with, the env map, or your settings files. If neuralinverse is not on Zed's PATH, use its absolute path (which neuralinverse).

Other ACP clients

Configure the command neuralinverse with the argument acp. Diagnostics go to standard error; add --verbose to see them.

What is supported

ACP featureBehaviour
initializeProtocol version 1; loadSession; prompt images and embedded context; HTTP and SSE MCP servers
session/newStarts a session in the client's working folder with your settings. MCP servers sent by the client are added to (and override same-named) configured servers, unless managed policy locks mcpServers
session/loadResumes a saved session and replays it
session/promptText, images, resource and resource_link blocks
session/updateMessage and thought chunks, tool calls and updates (diffs for edits, live command output), plan, current_mode_update
session/cancelStops the running prompt
session/request_permissionAllow once, always allow (session rule), reject, always reject (session deny rule)
session/set_modeask, auto-edit, read-only (plan), full-auto (hidden when policy disables it)
fs/read_text_file, fs/write_text_fileUsed when the client offers them: the file tools read the editor's buffer (including unsaved changes) and write through the editor

Stop reasons: end_turn, max_tokens, max_turn_requests (turn or budget limit), refusal, cancelled; provider failures are returned as errors. Tool calls carry a kind (read, edit, search, execute, fetch, think, other), a title, the files they touch and the raw input. Questions from the agent and plan approvals appear in the permission dialog, each answer as a button.

Sessions are saved like terminal sessions (unless --no-session-persistence), so a conversation started in the editor can be continued with neuralinverse --resume <id>, and the other way round.

Limitations

  • No ACP terminal integration yet: commands run in the agent's own shell, and their output is streamed into the tool call.
  • authenticate is accepted, but no authentication methods are offered; configure provider credentials the usual way.
  • Multi-select questions are not shown in editors; the agent continues with its own judgement.

VS Code

The Neural Inverse extension for VS Code runs the CLI locally (neuralinverse serve) and adds:

  • a chat view in the activity bar, with streamed answers, tool calls with live output, and edits with an Open diff button;
  • approvals in the conversation: Approve, Always allow (adds the suggested rule for the session), Deny, or Deny with a reason; questions and proposed plans get their own cards;
  • model and mode pickers, a Stop button, and a footer with context use, tokens and cost;
  • @ to attach a workspace file, or attach the current selection;
  • editor commands: Ask about selection, Add selection to chat, Explain file, Fix problems in file (sends VS Code's diagnostics), Review uncommitted changes;
  • a status bar item showing whether the agent is idle, working or waiting for approval.

Files the agent edits are reloaded in open editors; unsaved editor changes are never discarded.

Requirements and installation

  • VS Code 1.90 or newer.
  • The CLI with serve --json-ready support: npm i -g @neuralinverse/cli. Without a global install, the extension falls back to npx -y @neuralinverse/cli, which downloads it on first use.
  • At least one model provider configured for the CLI; check with neuralinverse doctor.

The extension is built from the CLI's source folder and installed from a .vsix file:

cd extensions/vscode
npm install
npm run package            # writes neuralinverse.vsix
code --install-extension neuralinverse.vsix

Keys

ShortcutAction
Ctrl+Shift+I / Cmd+Shift+IOpen the chat
Ctrl+Shift+Enter / Cmd+Shift+EnterAdd the editor selection to the chat
Enter / Shift+Enter in the chatSend / new line
Esc in the chat while the agent worksStop

Ctrl+Shift+I replaces VS Code's default binding for that key on some platforms; change it in Keyboard Shortcuts if you prefer the original.

Settings

SettingDefaultMeaning
neuralinverse.cliPath""Path to the neuralinverse executable or its .js entry point. Empty: neuralinverse on PATH, else npx -y @neuralinverse/cli
neuralinverse.model""Model for new sessions. Empty: the CLI's default
neuralinverse.modeaskPermission mode for new sessions
neuralinverse.autoStartServertrueStart the agent server when the chat view opens (otherwise on the first message)
neuralinverse.extraArgs[]Extra arguments for neuralinverse serve, for example ["--no-mcp"]
neuralinverse.chat.useEditorFontfalseShow the chat in the workbench font

Everything else (providers, permission rules, MCP servers, hooks) comes from the CLI's own settings files, exactly as in the terminal.

Last reviewed 17 October 2026View as Markdown

Editors · Docs · Neural Inverse