Command-line reference

Use csc on the computer that owns the project and credentials. For a guided first setup, use Get started; this page is for looking up commands and automation options.

See a command’s options

csc --version
csc --help
csc launch --help
csc account --help

Your installed build’s help shows the command syntax that build accepts. A command documented for a newer build may be missing from an older installation.

Toolkit commands start with csc toolkit, and the option that names a toolkit is –toolkit. It takes a toolkit’s name or its ID. Two toolkits can share a name, and then the command is refused with the IDs to choose from. In a –json answer, a toolkit is an object with its id and name.

Complete commands with Tab

Press Tab after csc to see the commands that can come next. Pick one and press Tab again to go to the next level, down to its flags. Depending on your shell, you’ll see a short description beside each choice or just the names.

After --toolkit, Tab lists your toolkits: the ones you pinned to the top of My toolkits in the desktop app, then the ones made for the coding app named by --host (Claude Code if there’s none), then the ones you launched most recently. After --host or --app, it offers claude and codex. Tab never goes over the network, so it answers right away, and a toolkit you just made appears after your next csc sync.

Tab works in zsh, bash, and fish on a Mac or on Linux, and there’s nothing to set up. Installing Code Config adds it, and on a computer that doesn’t have it yet, a command such as csc sync run in a terminal adds it and says so once. It works in the next new terminal you open. In zsh and bash this is a line at the end of your shell’s startup files, and if you take that line out, updates won’t put it back.

Common tasks and where they’re covered

Task	Guide or command
Install and sign in	Install Code Config, then csc login.
Set up with a coding agent	Get started; the setup flow returns its next action.
Start a coding app	Coding-app guides explain app-specific launch behavior.
Set a project’s default toolkit	Connect a project and choose defaults.
Get toolkit changes	csc sync.
Set up a server’s credential	Set up MCP credentials.
Choose a coding-app account	Coding-app accounts and models.
Receive web launch requests	csc listen on the destination computer.
Interpret a failure	Troubleshooting, including exit codes.

All management commands

The index below is generated from the command definitions of this build and lists its commands, launch, sign-in, and account included. csc listen, csc shell, and csc disconnect have their own help and are not in the index.

The displayed syntax contains placeholders, not runnable examples. Replace values such as <id> with your own IDs. Optional arguments can depend on other options; read the command’s help before applying a change.

csc repo get

Syntax:

csc repo get [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc repo get --help.

csc repo set

Syntax:

csc repo set --url <url> [options]

Option	Value	Required	Repeatable
--url	<url>	Yes	No
--role	<role>	No	No
--wait	None	No	No
--json	None	No	No

Allowed values and dependent options: csc repo set --help.

csc launch

Syntax:

csc launch [options]

Option	Value	Required	Repeatable
--host	<host>	No	No
--desktop	None	No	No
--toolkit	<toolkit>	No	Yes
--account	<account>	No	No
--strict	None	No	No
--prompt	<prompt>	No	No
--resume	<resume>	No	No
--fork	None	No	No
--stages	<stages>	No	No
--close-open-app	None	No	No
--json	None	No	No

Allowed values and dependent options: csc launch --help.

csc key get

Syntax:

csc key get [options]

Option	Value	Required	Repeatable
--toolkit	<toolkit>	No	No
--json	None	No	No

Allowed values and dependent options: csc key get --help.

csc key find

Syntax:

csc key find [options]

Option	Value	Required	Repeatable
--toolkit	<toolkit>	No	No
--json	None	No	No

Allowed values and dependent options: csc key find --help.

csc key set

Syntax:

csc key set [options]

Option	Value	Required	Repeatable
--toolkit	<toolkit>	No	No
--server	<server>	No	No
--app	<app>	No	No
--provider	<provider>	No	No
--instance	<instance>	No	No
--json	None	No	No

Allowed values and dependent options: csc key set --help.

csc key delete

Syntax:

csc key delete --setting <setting> [options]

Option	Value	Required	Repeatable
--toolkit	<toolkit>	No	No
--server	<server>	No	No
--app	<app>	No	No
--setting	<setting>	Yes	Yes
--json	None	No	No

Allowed values and dependent options: csc key delete --help.

csc key page

Syntax:

csc key page [options]

Option	Value	Required	Repeatable
--toolkit	<toolkit>	No	No
--no-open	None	No	No
--json	None	No	No

Allowed values and dependent options: csc key page --help.

csc key copy

Syntax:

csc key copy --to <to> [options]

Option	Value	Required	Repeatable
--to	<to>	Yes	No
--toolkit	<toolkit>	No	No
--json	None	No	No

Allowed values and dependent options: csc key copy --help.

csc sync

Syntax:

csc sync [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc sync --help.

csc setup

Syntax:

csc setup [options]

Option	Value	Required	Repeatable
--agent	None	No	No
--route	<route>	No	No
--phase	<phase>	No	No
--skill	None	No	No
--json	None	No	No

Allowed values and dependent options: csc setup --help.

csc setup run

Syntax:

csc setup run [options]

Option	Value	Required	Repeatable
--app	<app>	No	No
--toolkit	<toolkit>	No	No
--no-open	None	No	No
--wait	None	No	No
--json	None	No	No

Allowed values and dependent options: csc setup run --help.

csc setup usage

Syntax:

csc setup usage [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc setup usage --help.

csc toolkit switch

Syntax:

csc toolkit switch <toolkit> [options]

Option	Value	Required	Repeatable
--session	<session>	No	No
--conversation	<conversation>	No	No
--json	None	No	No

Allowed values and dependent options: csc toolkit switch --help.

csc toolkit live

Syntax:

csc toolkit live [<state>] [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc toolkit live --help.

csc toolkit get

Syntax:

csc toolkit get [options]

Option	Value	Required	Repeatable
--toolkit	<toolkit>	No	No
--files	None	No	No
--for	<for>	No	Yes
--json	None	No	No

Allowed values and dependent options: csc toolkit get --help.

csc toolkit set

Syntax:

csc toolkit set [options]

Option	Value	Required	Repeatable
--toolkit	<toolkit>	No	No
--add-tools	<add-tools>	No	Yes
--remove-tools	<remove-tools>	No	Yes
--mcp-url	<mcp-url>	No	Yes
--mcp-transport	<mcp-transport>	No	No
--mcp-header	<mcp-header>	No	Yes
--mcp-remove	<mcp-remove>	No	Yes
--include	<include>	No	Yes
--remove-include	<remove-include>	No	Yes
--default	None	No	No
--new-name	<new-name>	No	No
--status-line-json	<status-line-json>	No	No
--text-json	<text-json>	No	No
--settings-json	<settings-json>	No	No
--for	<for>	No	Yes
--follow	<follow>	No	No
--json	None	No	No

Allowed values and dependent options: csc toolkit set --help.

csc toolkit create

Syntax:

csc toolkit create --name <name> [options]

Option	Value	Required	Repeatable
--name	<name>	Yes	No
--add-tools	<add-tools>	No	Yes
--default	None	No	No
--json	None	No	No

Allowed values and dependent options: csc toolkit create --help.

csc toolkit delete

Syntax:

csc toolkit delete --toolkit <toolkit> [options]

Option	Value	Required	Repeatable
--toolkit	<toolkit>	Yes	No
--json	None	No	No

Allowed values and dependent options: csc toolkit delete --help.

csc toolkit adopt

Syntax:

csc toolkit adopt <slug> [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc toolkit adopt --help.

csc toolkit follow

Syntax:

csc toolkit follow <toolkit> [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc toolkit follow --help.

csc toolkit export

Syntax:

csc toolkit export --toolkit <toolkit> [options]

Option	Value	Required	Repeatable
--toolkit	<toolkit>	Yes	No
--to	<to>	No	No
--plugin	None	No	No
--json	None	No	No

Allowed values and dependent options: csc toolkit export --help.

csc toolkit preview

Syntax:

csc toolkit preview [options]

Option	Value	Required	Repeatable
--toolkit	<toolkit>	No	No
--host	<host>	No	No
--clean	None	No	No
--json	None	No	No

Allowed values and dependent options: csc toolkit preview --help.

csc toolkit share

Syntax:

csc toolkit share [options]

Option	Value	Required	Repeatable
--toolkit	<toolkit>	No	No
--subcategory	<subcategory>	No	Yes
--link-only	None	No	No
--copy-to-public	None	No	No
--stop	None	No	No
--json	None	No	No

Allowed values and dependent options: csc toolkit share --help.

csc catalog search

Syntax:

csc catalog search [<path>...] [options]

Option	Value	Required	Repeatable
--project	None	No	No
--query	<query>	No	No
--kind	<kind>	No	No
--cursor	<cursor>	No	No
--for	<for>	No	Yes
--category	<category>	No	No
--subcategory	<subcategory>	No	No
--json	None	No	No

Allowed values and dependent options: csc catalog search --help.

csc catalog get

Syntax:

csc catalog get [options]

Option	Value	Required	Repeatable
--slug	<slug>	No	No
--repo	<repo>	No	No
--tool	<tool>	No	No
--files	None	No	No
--json	None	No	No

Allowed values and dependent options: csc catalog get --help.

csc catalog index

Syntax:

csc catalog index --repo <repo> [options]

Option	Value	Required	Repeatable
--repo	<repo>	Yes	No
--json	None	No	No

Allowed values and dependent options: csc catalog index --help.

csc project get

Syntax:

csc project get [options]

Option	Value	Required	Repeatable
--path	<path>	No	No
--json	None	No	No

Allowed values and dependent options: csc project get --help.

csc project set

Syntax:

csc project set [options]

Option	Value	Required	Repeatable
--path	<path>	No	No
--toolkit	<toolkit>	No	No
--account	<account>	No	No
--host	<host>	No	No
--json	None	No	No

Allowed values and dependent options: csc project set --help.

csc project delete

Syntax:

csc project delete [options]

Option	Value	Required	Repeatable
--path	<path>	No	No
--host	<host>	No	No
--json	None	No	No

Allowed values and dependent options: csc project delete --help.

csc project remove

Syntax:

csc project remove [options]

Option	Value	Required	Repeatable
--path	<path>	No	No
--under	<under>	No	No
--dry-run	None	No	No
--json	None	No	No

Allowed values and dependent options: csc project remove --help.

csc project locate

Syntax:

csc project locate --project <project> [options]

Option	Value	Required	Repeatable
--project	<project>	Yes	No
--path	<path>	No	No
--json	None	No	No

Allowed values and dependent options: csc project locate --help.

csc project scan

Syntax:

csc project scan [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc project scan --help.

csc project sync

Syntax:

csc project sync [options]

Option	Value	Required	Repeatable
--path	<path>	No	No
--toolkit	<toolkit>	No	Yes
--host	<host>	No	No
--stages	<stages>	No	No
--json	None	No	No

Allowed values and dependent options: csc project sync --help.

csc status get

Syntax:

csc status get [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc status get --help.

csc computer get

Syntax:

csc computer get [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc computer get --help.

csc storage

Syntax:

csc storage [options]

Option	Value	Required	Repeatable
--clean	None	No	No
--json	None	No	No

Allowed values and dependent options: csc storage --help.

csc enroll

Syntax:

csc enroll [options]

Option	Value	Required	Repeatable
--name	<name>	No	No
--browser	None	No	No
--device-code	None	No	No
--force	None	No	No
--no-wait	None	No	No
--status	None	No	No
--api-base	<api-base>	No	No
--email	<email>	No	No
--agree	None	No	No
--workspace	<workspace>	No	No
--wait	None	No	No
--json	None	No	No

Allowed values and dependent options: csc enroll --help.

csc login

Syntax:

csc login [options]

Option	Value	Required	Repeatable
--name	<name>	No	No
--browser	None	No	No
--device-code	None	No	No
--force	None	No	No
--no-wait	None	No	No
--status	None	No	No
--api-base	<api-base>	No	No
--email	<email>	No	No
--agree	None	No	No
--workspace	<workspace>	No	No
--wait	None	No	No
--json	None	No	No

Allowed values and dependent options: csc login --help.

csc update

Syntax:

csc update [options]

Option	Value	Required	Repeatable
--auto	<auto>	No	No
--json	None	No	No

Allowed values and dependent options: csc update --help.

csc account get

Syntax:

csc account get [options]

Option	Value	Required	Repeatable
--host	<host>	No	No
--account	<account>	No	No
--json	None	No	No

Allowed values and dependent options: csc account get --help.

csc account add

Syntax:

csc account add <name> [options]

Option	Value	Required	Repeatable
--host	<host>	No	No
--import-current	None	No	No
--import-from	<import-from>	No	No
--empty	None	No	No
--api	None	No	No
--preset	<preset>	No	No
--endpoint	<endpoint>	No	No
--model	<model>	No	Yes
--key-stdin	None	No	No
--isolation	<isolation>	No	No
--json	None	No	No

Allowed values and dependent options: csc account add --help.

csc account set

Syntax:

csc account set --account <account> [options]

Option	Value	Required	Repeatable
--account	<account>	Yes	No
--host	<host>	No	No
--name	<name>	No	No
--api	None	No	No
--preset	<preset>	No	No
--endpoint	<endpoint>	No	No
--model	<model>	No	Yes
--key-stdin	None	No	No
--subscription	None	No	No
--import-current	None	No	No
--isolation	<isolation>	No	No
--json	None	No	No

Allowed values and dependent options: csc account set --help.

csc account delete

Syntax:

csc account delete --account <account> [options]

Option	Value	Required	Repeatable
--account	<account>	Yes	No
--host	<host>	No	No
--json	None	No	No

Allowed values and dependent options: csc account delete --help.

csc account sign-in

Syntax:

csc account sign-in --account <account> [options]

Option	Value	Required	Repeatable
--account	<account>	Yes	No
--host	<host>	No	No
--stages	<stages>	No	No
--json	None	No	No

Allowed values and dependent options: csc account sign-in --help.

csc account copy

Syntax:

csc account copy --to <to> [options]

Option	Value	Required	Repeatable
--to	<to>	Yes	No
--account	<account>	No	No
--host	<host>	No	No
--json	None	No	No

Allowed values and dependent options: csc account copy --help.

csc account-mode get

Syntax:

csc account-mode get [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc account-mode get --help.

csc account-mode set

Syntax:

csc account-mode set --mode <mode> [options]

Option	Value	Required	Repeatable
--mode	<mode>	Yes	No
--json	None	No	No

Allowed values and dependent options: csc account-mode set --help.

csc settings credit

Syntax:

csc settings credit [<state>] [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc settings credit --help.

csc plan

Syntax:

csc plan [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc plan --help.

csc feedback

Syntax:

csc feedback [options]

Option	Value	Required	Repeatable
--kind	<kind>	No	No
--about	<about>	No	No
--name	<name>	No	No
--message	<message>	No	No
--file	<file>	No	No
--retry	None	No	No
--json	None	No	No

Allowed values and dependent options: csc feedback --help.

csc workspace

Syntax:

csc workspace [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc workspace --help.

csc workspace use

Syntax:

csc workspace use <workspace> [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc workspace use --help.

csc session current

Syntax:

csc session current [options]

Option	Value	Required	Repeatable
--session	<session>	No	No
--conversation	<conversation>	No	No
--json	None	No	No

Allowed values and dependent options: csc session current --help.

csc session open

Syntax:

csc session open --project <project> --public-key <public-key> [options]

Option	Value	Required	Repeatable
--project	<project>	Yes	No
--public-key	<public-key>	Yes	No
--toolkit	<toolkit>	No	Yes
--stages	<stages>	No	No
--isolated-account	<isolated-account>	No	No
--json	None	No	No

Allowed values and dependent options: csc session open --help.

csc session close

Syntax:

csc session close <session> [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc session close --help.

csc session pack

Syntax:

csc session pack <session> [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc session pack --help.

csc session check

Syntax:

csc session check <session> [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc session check --help.

csc mcp status

Syntax:

csc mcp status [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc mcp status --help.

csc mcp retry

Syntax:

csc mcp retry [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc mcp retry --help.

csc mcp sign-in

Syntax:

csc mcp sign-in <server> [options]

Option	Value	Required	Repeatable
--session	<session>	No	No
--json	None	No	No

Allowed values and dependent options: csc mcp sign-in --help.

csc tool save

Syntax:

csc tool save <path> [options]

Option	Value	Required	Repeatable
--json	None	No	No

Allowed values and dependent options: csc tool save --help.

Command details for scripts

Download command metadata for the exact management and runtime definitions used by this documentation build, including allowed values and cross-option constraints. Runtime execution commands support coding-app integration and do not replace setup.

Commands that support --json return structured output. Check both the exit code and the reported outcome. A process starting successfully does not prove that every toolkit item was configured.

Using commands in scripts safely

Check the specific command’s help before using a flag. Review changes before applying them, and obtain approval for account, publication, or destructive operations. Supply credentials through supported local inputs or standard input, never as command-line values. Do not edit Code Config’s managed state files by hand.