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.

PlatformPackageNotes
Linux.deb · x86_64Signed package
macOSuniversal · arm64 + x86_64Unsigned · Gatekeeper guide included
Windowsx86_64Unsigned · 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:

CommandWhat it does
/modelPick the model (live list from your provider)
/thinkingToggle thinking mode
/effortSwitch reasoning effort (high ⇄ max)
/streamToggle streamed responses
/swarm <mission>Dispatch a swarm from within the REPL
/apiView 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 /effort or /thinking to 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.
Next: understand the system in Architecture, or review the Security posture before running agents on sensitive code.