基本操作

setup

orc setup は、CLIに同梱されたスキルをエージェントが読むディレクトリへ導入し、導入状態を確認・解除するコマンドです。MCPのローカル登録設定を書き込む操作もあります。

スキルの導入はローカルファイルの操作です。MCPの接続には hosted MCPのワークフロー を使用してください。setup mcp は orc mcp serve を呼ぶ設定を作りますが、その実行コマンドは提供されていません。

使い方

terminal
orc setup skills --agent codex

Codexのプロジェクト用ディレクトリへスキルを導入します。

サブコマンド

skills

埋め込み済みスキルをcanonicalな .agents/skills ディレクトリへコピーし、対象エージェントのスキルディレクトリへリンクします。Windowsではjunctionを使用し、リンクを作れない場合は同じ内容をコピーします。--status は installed・missing・broken・version-drift の状態を確認します。

terminal
orc setup skills [options]

固有のオプション

--status

List installed / missing / broken / version-drift state

型: boolean。任意。

terminal
orc setup skills --status
--uninstall

Remove installed Orchestor skill symlinks from agent skill paths

型: boolean。任意。

terminal
orc setup skills --uninstall
--force

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

型: boolean。任意。

terminal
orc setup skills --force
--only

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

型: string。任意。

terminal
orc setup skills --only <value>
--agent

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

型: string。任意。

terminal
orc setup skills --agent <value>
--all

Target every supported agent skill directory

型: boolean。任意。

terminal
orc setup skills --all
--global

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

型: boolean。任意。

terminal
orc setup skills --global

mcp

--target project(既定値)では .mcp.json、--target claude-desktop ではClaude Desktopの設定へOrchestorのローカルサーバー登録を書き込みます。登録される orc mcp serve は実行できないため、この設定の作成だけでは接続は完了しません。

terminal
orc setup mcp [options]

固有のオプション

--target

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

型: string。任意。

terminal
orc setup mcp --target <value>

使用例

導入状態を確認します。

terminal
orc setup skills --agent codex --status

導入状態を確認します。

すべての対応エージェントのuser-levelへ導入します。

terminal
orc setup skills --all --global

すべての対応エージェントのuser-levelへ導入します。

Codexの導入リンクを解除します。

terminal
orc setup skills --agent codex --uninstall

Codexの導入リンクを解除します。

導入先と解除

既定ではcanonical copyをuser-levelの ~/.agents/skills に置き、Claude Codeのuser-levelディレクトリを対象にします。--agent または --all はproject-levelを対象にし、--global を加えるとuser-levelへ導入します。--only はスキルslugをカンマで指定し、省略時は同梱スキルすべてを対象にします。

--force は既存のsymlinkを確認なしで置き換え、通常のパスはスキップします。--uninstall は対象エージェントのOrchestorスキルsymlinkだけを削除し、canonical copyと通常のディレクトリは削除しません。

グローバルオプション

orc setup では、次のグローバルオプションを使用できます。

各オプションの詳細と使用例は、グローバルオプションを参照してください。