CLI commands

codemany is the daemon and its command line. On a Mac it is bundled in Codemany.app; on Linux it is the package itself. codemany help prints this list.

Set up and run

codemany setup --target owner/repo|org:name [--size N [--overcommit]] [--labels a,b]
               [--listen addr | --localhost-only] [--config path] [--token-from-gh | --token-stdin] [--force]
               [--isolation host|user|vm [--vm-image path]]

Writes the config: what to serve, how many runners (--size defaults to what the machine supports), extra labels, where the dashboard listens, and the GitHub token. --isolation defaults to host; omitted on a re-run, the current mode is kept.

Command	What it does
`codemany serve [--config path] [--log-files] [--setup-listen addr]`	Runs the daemon. Without a config it serves first-run setup
`codemany setup-link [--port N]`	Prints the first-run setup link
`codemany install-service [--config path] [--setup-listen addr]`	Installs and starts the service (standalone binary only; Codemany.app manages its own)
`codemany uninstall-service`	Stops and removes the service
`sudo codemany system-setup [--user name] [--user-isolation [--slots N]] [--uninstall]`	Linux: the keep-awake permission (the .deb and install.sh run it) and, with `--user-isolation`, the helper for isolation `user`
`codemany version`	Prints the version

Check

Command	What it does
`codemany status [--url http://127.0.0.1:8825]`	The runners and their state
`codemany doctor [--json] [--config path]`	Health checks, and the tools runner jobs get on this machine with their labels
`codemany capacity [--json]`	How many runners this machine supports, and what limits it

Control

Command	What it does
`codemany drain [--wait] [--timeout 30m] [--url …] [--config path]`	Stops taking new jobs; `--wait` waits for running ones to finish
`codemany resume [--url …] [--config path]`	Takes jobs again
`codemany admin-token [--rotate] [--config path]`	The token for drain, resume and recycle from a browser or the LAN

drain and resume send the local admin token; set $CODEMANY_ADMIN_TOKEN to control another machine. Restart without cutting a job short: codemany drain --wait && systemctl --user restart codemany && codemany resume.

Runners

Command	What it does
`codemany isolation [status\|host\|user\|vm\|vm-image\|remove-users] [--json] [--vm-image path] [--config path]`	Runner isolation: `host` (default), `user` or `vm`. See Isolation
`codemany integrations list\|install <id>\|update <id>\|start <id>\|prewarm\|cancel <id>`	Docker, Homebrew packages and the tool cache. See Tools and caching

Fleet and license

Command	What it does
`codemany machines [list \| add ADDRESS CODE \| rename ID NAME \| remove ID]`	This machine's fleet. See The fleet
`codemany pair`	Prints the one-time code another Codemany needs to add this machine
`codemany license activate --owner ID [--token-stdin]`	Takes a seat of an owner's subscription, without a screen

Privacy and secrets

Command	What it does
`codemany analytics [status\|on\|off] [--json] [--config path]`	Anonymous usage stats, on by default. Privacy lists what is sent
`codemany featured [status\|on\|off] [--json] [--config path]`	Show your GitHub account and organisations on codemany.com (off by default)
`codemany vault [status\|keyring\|file]`	Linux: keep secrets in the 0600 file (the default) or the desktop keyring, locked until you log in