1
Start your free trial
Go to app.octopoda.dev/start and sign in with GitHub. Pick a plan and continue to checkout on Stripe.The trial lasts 14 days and includes 5 credits, enough for one code scan. Your card is not charged until the trial ends, and you can cancel any time before then. See Free trial.
2
Install the CLI
Run the installer in your terminal:It downloads the
octopoda binary for your machine, checks it against the signed release list, and puts it on your PATH. See Install the CLI for options.3
Sign in this device
4
Scan your project
From your project folder, run:The CLI packs your code (leaving out secrets such as
.env files), uploads it and starts a code scan, which uses 5 credits. It then follows the scan and prints what Octopoda is doing. You can press Ctrl+C at any time: the scan keeps running, and you can check it later with octopoda status.When the scan ends, the CLI lists each proven finding with its key, such as F-1, and where it is in your code.5
Fix a finding
Print a finding’s fix prompt:Paste the prompt into Cursor or Claude Code, review the change your AI tool makes, and scan again to confirm the issue is gone. See Fix a finding with your AI tool.
Next steps
Check every pull request
Install the GitHub App so new code is scanned before it merges.
Scan from your AI tool
Add Octopoda to Cursor or Claude Code over MCP.