setup
Initialize the project or global configuration by locating the config directory and generating a starter config.toml with default settings. Optionally write the file, trust the workspace, and install missing adapter packages.
Instructions
Show where config lives and scaffold a starter config.toml; the first-run helper.
scope is project (<cwd>/.rutherford/config.toml) or global (the platform config dir's
config.toml). It returns the proposed starter content (the most useful settings at their effective
defaults) and the resolved path, plus a snapshot of the agents you already have. Pass write=true to
create the file -- it never overwrites an existing one (already_exists=true, written=false).
trust_workspace=true adds the current directory to trusted_workspaces so write/yolo delegations are
permitted there.
The adapters block reports agents whose underlying CLI is installed but whose npm ACP adapter shim is
not (codex needs codex-acp, claude_code needs claude-agent-acp, pi needs pi-acp -- what doctor
flags as not_installed with an install hint). Pass install_adapters=true to run npm i -g <package>
for each of those automatically (an explicit, opt-in machine change; off by default).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scope | No | project | |
| write | No | ||
| trust_workspace | No | ||
| install_adapters | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |