Reference
CLI reference
Every loopcode command, subcommand and flag — interactive sessions, headless runs, MCP, plugins, GitHub, access tokens, your plan and maintenance.
#Sessions
| Command | Does |
|---|
loopcode | Start a conversation in the current folder |
loopcode "<prompt>" | Start one with that request already sent |
loopcode -c | Continue the most recent conversation here |
loopcode -r <id> | Continue an earlier conversation (an id prefix is enough) |
loopcode -p "<prompt>" | Run one prompt without a screen; the answer goes to stdout. See Headless mode |
loopcode -p "<prompt>" --json | The same, printing every run event as a JSON line |
loopcode sessions | List the conversations in this folder |
#Options
| Flag | Meaning |
|---|
-m, --model <id> | The model to use. See Models and effort |
--mode <mode> | auto (the default: a reviewer checks risky commands), acceptEdits, default or plan. See Permissions |
--permission-mode <mode> | The same as --mode |
--effort <level> | low, medium (the default), high, extra or max |
-C, --workspace <dir> | Run in another folder |
-w, --worktree [name] | Work in a new git worktree on its own branch (.loopcode/worktrees/<name>); on exit, keep it, merge it, or remove it |
--state <dir> | Where conversations and your sign-in are kept (default ~/.loopcode/cli) |
-c, --continue | Continue the most recent conversation in this folder |
-r, --resume <id> | Continue a particular conversation |
-y, --yes | Headless: approve every permission the run asks for (default: deny) |
-q, --quiet | Headless: no tool activity on stderr |
--output-format <f> | Headless: text (default), json (one result object) or stream-json (every event) |
--json | The same as --output-format stream-json |
--max-turns <n> | Headless: stop after this many model calls |
--append-system-prompt <text> | Headless: extra instructions for this run |
--dangerously-skip-permissions | Nothing asks before acting. Only for a disposable sandbox or container |
-v, --version | Print the version |
-h, --help | Print the help |
#Your plan and account
| Command | Does |
|---|
loopcode login | Sign in: approve the code in your browser, no token to paste |
loopcode logout | Sign out on this machine |
loopcode usage | Your plan, and how much of its usage windows is used |
loopcode upgrade [pro|max] | Pay for Pro or Max in the browser; the terminal follows when it clears. renew and billing work too |
loopcode token create [--label <name>] | Create an access token for CI, used as LOOPCODE_TOKEN. Shown once |
loopcode token list | Your access tokens and when each was last used |
loopcode token revoke <id> | Switch a token off |
loopcode feedback [message] | Write to the LoopCode team; opens a draft in your mail app |
#MCP servers
| Command | Does |
|---|
loopcode mcp catalog | The directory of ready-made servers |
loopcode mcp add <directory-id> | Add one from the directory; OAuth ones open the browser to sign in |
loopcode mcp add <name> -- <command> [args…] | A local server that talks over stdio |
loopcode mcp add --transport http <name> <url> | A remote server (streamable HTTP; sse also works) |
loopcode mcp add-json <name> '<json>' | A server written as JSON |
loopcode mcp list | Every server, its state and its tools |
loopcode mcp get <name> | One server's configuration and status |
loopcode mcp remove <name> | Remove it |
loopcode mcp login <name> | Sign in to a remote server in the browser |
loopcode mcp logout <name> | Forget that sign-in |
loopcode import | Bring in the MCP servers you set up for Claude Code or Codex |
mcp add options: -s, --scope project|user; -e, --env KEY=value (repeatable); -H, --header "Name: value" (repeatable); -t, --transport http|sse. See MCP servers.
#Plugins
| Command | Does |
|---|
loopcode plugin list | Installed plugins, from LoopCode and from Claude Code |
loopcode plugin search [words] | What the marketplaces offer |
loopcode plugin install <name>[@market] | Install one |
loopcode plugin uninstall <name> | Remove one installed here |
loopcode plugin enable|disable <name> | Turn one on or off for LoopCode |
loopcode plugin marketplace add <source> | Add a marketplace: GitHub owner/repo, a git URL, or a folder |
loopcode plugin marketplace list | Your marketplaces |
#GitHub
| Command | Does |
|---|
loopcode github install [--force] | Set this repository up: the LOOPCODE_TOKEN secret and .github/workflows/loopcode.yml |
loopcode github run | What that workflow runs: reads the GitHub event and acts on it |
See GitHub reviews and fixes.
#Maintenance
| Command | Does |
|---|
loopcode update | Update now. Installed copies also update themselves in the background (LOOPCODE_NO_AUTOUPDATE=1 turns that off) |
loopcode doctor | Check this install, your sign-in, the connection and the tools; says what to fix |
loopcode app install | Install the desktop app on macOS or Windows, checked before it goes in |
loopcode completion bash|zsh|fish | Shell completion for loopcode's commands and options |
loopcode auto-review defaults | The policy auto-review checks commands against, and how to add to it |
LoopCode