​

setup

orc setup installs skills bundled with the CLI into directories read by agents, checks installation state, and removes installed links. It also has a local MCP registration writer.

Skill installation operates on local files. Use the hosted MCP workflow for a working MCP connection. setup mcp writes a registration invoking orc mcp serve, but that executable command is not provided.

Install skills into the project-level Codex directory.

Copies embedded skills into the canonical .agents/skills directory and links target agent skill directories to that copy. Windows uses junctions; if linking fails, the command copies the same content. --status checks installed, missing, broken, and version-drift states.

List installed / missing / broken / version-drift state

Type: boolean. Optional.

Remove installed Orchestor skill symlinks from agent skill paths

Type: boolean. Optional.

Replace existing symlinks without prompting; non-symlink paths are skipped

Type: boolean. Optional.

Comma-separated skill slugs to install (default: all bundled skills)

Type: string. Optional.

Target one agent runtime (for example: codex or claude-code)

Type: string. Optional.

Target every supported agent skill directory

Type: boolean. Optional.

Install to user-level agent directories instead of the current project

Type: boolean. Optional.

--target project (the default) writes an Orchestor local server registration in .mcp.json; --target claude-desktop writes Claude Desktop configuration. The registered orc mcp serve command is unavailable, so writing this configuration alone does not complete a connection.

Config target: project (.mcp.json) or claude-desktop

Type: string. Optional.

Check installation state.

Install for all supported agents at user level.

Remove installed Codex links.

By default, the canonical copy is stored at user-level ~/.agents/skills, targeting the user-level Claude Code directory. --agent or --all targets project-level directories; add --global for user-level installation. --only accepts comma-separated skill slugs and defaults to all bundled skills.

--force replaces existing symlinks without prompting and skips regular paths. --uninstall removes only Orchestor skill symlinks in target agent directories, leaving the canonical copy and regular directories intact.

The following global options can be used with orc setup:

For details and examples, see global options.