Getting started

​
Update, switch, and remove setup

Before updating, inspect the version, credential status, workspace, and Skills state.

​
Steps

orc --version
orc status --json
orc workspace current --json
orc setup skills --agent codex --status

Choose a published version in the release notes and reinstall that version with the original package manager. orc update installs the beta channel; --check reports distribution information and does not prove that no newer version exists. After updating, repeat Skills status and the required data read. For link drift, inspect a dry run and repair the intended target with --force; ordinary files are not replaced.

Workflow index · Setup reference

​
Remove setup

orc setup skills --agent codex --uninstall
orc workspace unlink
orc auth logout

Use the same agent and scope flags used at installation; add --global for a user-wide install. Logout removes stored CLI credentials; it does not revoke a key injected through the environment or disconnect MCP OAuth. Remove CI secrets and revoke unused keys in their owning management surface. Disconnect MCP through the client guide. Remove Skills links before uninstalling the CLI with the original package manager.

If a failure remains, report it and verify the fix, including this workflow and the failed step.