Skip to main content

ish mcp list

Show detected clients and ish MCP wiring status Usage: ish mcp list

ish mcp add

Wire the ish MCP server into selected client configs Usage: ish mcp add [options]

Options

--client <names>
string
Comma-separated and/or repeatable: cursor, vscode, claude-code, claude-desktop, windsurf Default: [].
--all
boolean
Wire every detected client on this OS
--dry-run
boolean
Print planned mutations as JSON; write nothing
--force
boolean
Overwrite an existing ish server block that has drifted
-y, --yes
boolean
Confirm writes (required when stdout is piped or —json is set)

ish mcp remove

Remove the ish server block from selected client configs Usage: ish mcp remove [options]

Options

--client <names>
string
Comma-separated and/or repeatable: cursor, vscode, claude-code, claude-desktop, windsurf Default: [].
--all
boolean
Remove from every detected client on this OS
--dry-run
boolean
Print planned mutations as JSON; write nothing
-y, --yes
boolean
Confirm writes (required when stdout is piped or —json is set)

ish init

Install the ish Agent Skill into a project (Claude Code, Codex, Cursor, Cline, Roo Code) Usage: ish init [options]

Options

--target <which>
string
Where to install: claude (.claude/skills/ish), agents (.agents/skills/ish), or both Default: “claude”.
--dir <path>
string
Write to a custom directory instead of a recognised target path
--stdout
boolean
Print the SKILL.md to stdout instead of writing files (skips references/)
--force
boolean
Overwrite existing files in the target directory

Global flags

Every command accepts the global flags.
-V, --version
boolean
output the version number
-t, --token <token>
string
Auth token (or set ISH_TOKEN env var)
--token-file <path>
string
Read auth token from a file (preferred over —token / ISH_TOKEN)
--workspace <id>
string
Default workspace ID; per-subcommand —workspace overrides
--json
boolean
Output as JSON (auto-enabled when piped)
--get <field>
string
Extract a single field from the JSON response and print only its value (implies —json internally; supports dotted paths e.g. person.name)
--human
boolean
Force human-readable output even when stdout is piped (overrides JSON-when-piped auto-detection)
--fields <fields>
string
Comma-separated fields to include in JSON output (e.g. alias,name,status)
--verbose
boolean
Include full UUIDs and timestamps in JSON output
--no-color
boolean
Disable colored output (also honored: NO_COLOR env var)
-q, --quiet
boolean
Suppress progress messages on stderr (no-op for read commands that emit none)