Documentation
Onboarding
From zero to your first autonomous swarm in a few minutes. This guide covers installing and the core commands you'll use day to day.
1 · Get RaptorCode
RaptorCode runs on Linux, macOS, and Windows. The Linux build is available now — download it directly from the home page, no signup required. macOS and Windows are in invite-only early access: request access and you'll be emailed a download link.
2 · Install
Official builds are distributed through raptorcode.dev.
Invite downloads list a SHA-256 checksum next to each build — verify the
checksum whenever one is provided.
| Platform | Package | Notes |
|---|---|---|
| Linux | .deb · x86_64 | Signed package |
| macOS | universal · arm64 + x86_64 | Unsigned · Gatekeeper guide included |
| Windows | x86_64 | Unsigned · SmartScreen guide included |
Verify and install on Linux, for example:
sha256sum raptor-code_x.y.z_amd64.deb # compare to the value on the download page
sudo dpkg -i raptor-code_x.y.z_amd64.deb
raptor --version 3 · First run
Launch the interactive REPL by running raptor with no arguments.
The first time, it asks once for your model API key and stores it locally
(with restrictive permissions) for reuse. Before any agentic action, it asks
for per-session consent to work with your filesystem.
raptor 4 · Core commands
Inside the REPL, slash commands control the session:
| Command | What it does |
|---|---|
/model | Pick the model (live list from your provider) |
/thinking | Toggle thinking mode |
/effort | Switch reasoning effort (high ⇄ max) |
/stream | Toggle streamed responses |
/swarm <mission> | Dispatch a swarm from within the REPL |
/api | View or change your API key |
5 · Your first swarm
The headline feature is the live swarm. Give it a mission and it forks four specialist agents into isolated worktrees:
raptor swarm run "add a health-check endpoint and tests" Watch the 2×2 dashboard as the frontend, backend, test, and security agents work in parallel. When the run finishes, the changes wait uncommitted in each worktree. Review the diffs, run your tests, and merge what you want — nothing lands without you.
Tips
- Sessions start in ultrathink (max reasoning). Use
/effortor/thinkingto trade depth for speed. - Keep missions concrete and outcome-focused — "add Stripe checkout" beats step-by-step instructions.
- Always review the diff. RaptorCode is autonomous, but you are the merge gate.