Quickstart

Get RAPID running in your project in under 5 minutes.

Initialize a Project

Navigate to your project (or create a new one):
Terminal window
```
mkdir my-project && cd my-project
```
Initialize RAPID:
Terminal window
```
rapid init --template typescript
```
This creates:
- rapid.json — RAPID configuration
- .envrc — Secure secrets loading (safe to commit)
- .devcontainer/ — Dev container configuration
- CLAUDE.md — AI instruction file

Configure your secrets:

Edit rapid.json to point to your 1Password vault:

{
  "secrets": {
    "provider": "1password",
    "vault": "Development",
    "items": {
      "ANTHROPIC_API_KEY": "op://Development/Anthropic/api-key"
    }
  }
}

Allow direnv:
Terminal window
```
direnv allow
```
Start the environment:
Terminal window
```
rapid start
```
Launch AI coding session:
Terminal window
```
rapid dev
```

What Just Happened?

When you ran rapid start, RAPID:

Built and started a dev container based on your template
Loaded secrets from 1Password into the container environment
Installed AI CLI tools (Claude Code, OpenCode) inside the container
Generated/updated the CLAUDE.md instruction file

When you ran rapid dev, RAPID:

Attached to the running container
Launched your configured AI coding assistant (Claude by default)
The AI tool reads CLAUDE.md for project context

Common Workflows

Switch AI Agents

# Use a different agent for this session
rapid dev --agent aider

# Or change the default
rapid agent default opencode

Run Multiple Agents

# Launch all configured agents in split panes
rapid dev --multi

Rebuild Environment

# After changing devcontainer.json or Dockerfile
rapid start --rebuild

Stop Environment

rapid stop

Project Structure

After initialization, your project looks like:

my-project/
├── rapid.json              # RAPID configuration
├── .envrc                  # Secret references (safe to commit)
├── CLAUDE.md               # AI instruction file
├── AGENTS.md               # Generic AI instructions
└── .devcontainer/
    └── devcontainer.json   # Container configuration