Onboarding Checklist
Complete these steps to get the most out of Raziel.
When you first sign in, Raziel shows a checklist on your dashboard to guide you through the essential setup. Once all required steps are complete the card disappears automatically. You can also dismiss it at any time.
Required steps
1. Connect your GitHub account
Go to Settings and click Connect GitHub. Raziel uses your GitHub OAuth token to list your repositories so you can link them to projects and sessions. Without this you cannot create projects from private repos.
2. Add an API key
Go to Settings → API Keys and add at least one provider key (Anthropic or OpenAI). This key is encrypted at rest and injected into every sandbox so the agent can call the model API without you having to set it manually per session.
3. Create your first project
Go to Projects → New Project and pick a repository. Raziel will run a one-time build agent that installs dependencies, detects the run command, and snapshots the sandbox. Future sessions boot from that snapshot — typically in seconds.
4. Launch your first session
Open a project and click New Session. Choose your agent (Claude Code, Codex, etc.), set an optional starting prompt, and click Launch. The agent spins up inside an isolated sandbox with your repo pre-cloned and dependencies pre-installed.
Bonus step
Try a session template
Go to Templates to browse community-contributed session starters. Templates pre-fill the agent, system prompt, and environment variables so you can hit the ground running for common tasks (e.g. "add Stripe checkout", "write Playwright tests", "refactor to TypeScript").
Dismissing the checklist
Click Don't show this again (or the X button) to hide the checklist permanently. This marks onboardingComplete on your account. You can always revisit these steps from Settings or the docs.
What's next?
- Quickstart — end-to-end walkthrough of your first session
- Agents — configure agent-specific flags and models
- API Reference — automate session creation via the REST API