# Settings and commands

Every command and setting the VS Code extension adds, read from its manifest (version 0.2.1). The desktop app reads the same settings from its own `settings.json`, written without the `orbit.` prefix.

## Commands

Run these from the Command Palette.

| Command | ID |
| --- | --- |
| Orbit Code: Open | `orbit.open` |
| Orbit Code: Ask Claude… | `orbit.prompt` |
| Orbit Code: Stop Claude | `orbit.interrupt` |
| Orbit Code: New Claude Conversation | `orbit.newSession` |
| Orbit Code: Reindex Workspace | `orbit.reindex` |

## Settings

### `orbit.maxFiles`

Maximum number of source files to index. Larger workspaces are truncated.

Type `number`, default `20000`, at least `100`.

### `orbit.claude.path`

Path to the `claude` executable. Empty searches `PATH` and the default install locations.

Type `string`, default `""`, set per machine, never by a workspace.

### `orbit.claude.model`

Model alias or id passed to Claude Code as `--model`, for example `opus` or `sonnet`. Empty uses Claude Code's own default. The picker in the Orbit Code panel overrides this until the window reloads.

Type `string`, default `""`.

### `orbit.claude.effort`

Effort level passed to Claude Code as `--effort`: how much Claude thinks before answering. Empty uses Claude Code's own default. A model that takes no effort level, such as Haiku, ignores it. The effort meter in the Orbit Code panel overrides this until the window reloads.

Type `string`, default `""`, one of ``, `low`, `medium`, `high`, `xhigh`, `max`.

### `orbit.claude.permissionMode`

Permission mode for new Claude sessions. Bypass can only be chosen here, never from the panel.

Type `string`, default `"default"`, one of `default`, `acceptEdits`, `plan`, `bypassPermissions`, set per machine, never by a workspace.

### `orbit.claude.extraArgs`

Extra arguments appended to every `claude` invocation, for example `["--add-dir", "../shared"]`.

Type `array`, default `[]`, set per machine, never by a workspace.