octopoda command and flag. Run octopoda help to print the same summary in your terminal. Commands other than login, update and version need you to be signed in, or OCTOPODA_TOKEN to be set.
octopoda login
Signs this device in to your Octopoda account.
Each signed-in device appears in Settings → CLI sessions in the web app, where you can sign it out.
octopoda scan
Packs a project folder, uploads it and starts a code scan, then follows it until it ends.
path defaults to the current folder. Flags can come before or after it. A code scan uses 5 credits. See Choose what gets scanned for what is uploaded.
While it follows the scan, the CLI prints each stage and each finding as it is proven. Press Ctrl+C to stop following; the scan keeps running. When the scan ends, the CLI lists the findings, most severe first, and suggests the
octopoda fix command for the first one.
The command exits with code 1 if the scan failed, or if --fail-on matched a finding. See exit codes.
octopoda status
Shows a scan: its stage and the findings so far while it runs, or its result once it has ended.
scan, shows your latest scan. Pass a scan ID, which starts with scn_ and appears in the scan’s link, to show another.
octopoda findings
Lists the open findings in your account, grouped by repository or upload, with each finding’s key, severity, title and location.
octopoda fix
Prints a finding’s fix prompt, ready to paste into Cursor or Claude Code.
finding is a key such as F-142 (the F- is optional) or a finding ID. In a terminal, the CLI prints the severity, title and what is wrong before the prompt. When the output is piped, it prints only the prompt:
octopoda mcp
Runs the Octopoda MCP server over standard input and output, for AI coding tools. You don’t run it yourself: your AI tool starts it. See MCP server.
octopoda whoami
Shows who the CLI is signed in as: your GitHub username, the account, your role and its plan.
octopoda logout
Signs this device out on Octopoda and deletes the saved sign-in.
octopoda update
Installs the latest version of the CLI after checking its checksum and signature. See Install and update the CLI.
octopoda version
Prints the installed version. octopoda --version and octopoda -v do the same.