Skip to main content
This quickstart takes you from no account to a finished Octopoda scan of your own project. You need a GitHub account, a payment card for the free trial, and a Mac or Linux machine (on Windows, use WSL). A first scan usually takes 10 to 30 minutes.
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

The CLI prints a code and opens your browser. Check that the code in the browser matches the one in your terminal, then approve. The terminal confirms:
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.
You can also start a scan from the web app: connect GitHub, choose your repositories, and select New scan.

​
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.