Clawrp orchestrates a team of Claude Code agents that run your business autonomously — research, social media, analytics, customer support. Agents wake on schedule, delegate to each other, and you manage them through Slack.

Quick Start

Prerequisites

Node.js 20+ and pnpm 9+
Claude Code CLI installed and logged in (claude --version)
A Mac (agents use your local Claude Max plan session)

Install & Run

npx clawrp onboard
npx clawrp run

Or from source:

git clone <repo-url>
cd clawrp
pnpm install
pnpm dev

Open http://localhost:3100 — you'll see the Clawrp dashboard.

Set Up Your First Agent

Create a company in the dashboard (click "New Company", give it a name and mission)
Set up agent workspaces:
```
./scripts/setup-agents.sh
```
This copies agent templates to ~/agents/ (CEO, Researcher, Social Media, Engagement, Analytics).
Register the CEO agent — in the dashboard, click "New Agent":
- Name: CEO
- Adapter: claude_local
- Working directory: /Users/you/agents/ceo
- Model: opus (or sonnet for faster/cheaper)

Invoke the agent — click "Invoke" on the agent card, or:

curl -X POST http://localhost:3100/api/agents/{agent-id}/wakeup \
  -H "Content-Type: application/json" \
  -d '{"source": "on_demand", "reason": "First run"}'

Watch it work — the agent's run appears in the dashboard with live logs.

Connect Slack (Optional)

Create a Slack app using the manifest at http://localhost:3100/api/onboarding/slack-manifest
Enable Socket Mode in your Slack app settings

Add environment variables to .env:

SLACK_BOT_TOKEN=xoxb-...
SLACK_APP_TOKEN=xapp-...
SLACK_SIGNING_SECRET=...
CLAWRP_COMPANY_ID=your-company-uuid

Restart the server — the Slack bot connects automatically
Message your CEO agent in Slack!

What It Does

You define a company with a mission. AI agents run it:

Agent	Schedule	What it does
CEO	On-demand (Slack)	Full computer control. Coordinates all agents. Can hire new ones.
Researcher	Daily 10 AM	Researches trending topics, hands report to Social Media.
Social Media	On assignment	Writes platform-specific posts, publishes to Twitter/LinkedIn.
Engagement	Every 2 hours	Monitors replies, responds authentically.
Analytics	Daily 9 AM	Mixpanel funnel analysis, proposes experiments.

All on your Mac. All on your Max plan. Zero API costs.

Key Features

Claude Code native — Agents ARE Claude Code processes with skills, CLAUDE.md, and MCP servers
Max plan auth — Uses your local CLI session, not API keys ($0)
Full computer control — CEO agent has AppleScript, browser, apps, file system
Slack interface — Message agents, get responses in threads
Cron scheduling — Real cron expressions (0 10 * * *), not just intervals
Agent delegation — Agents create tasks and assign to each other with auto-wakeup
Persistent memory — Per-agent memory files + structured stateJson API
Per-agent MCP servers — Playwright, Mixpanel, Twitter, or any MCP server
Budget enforcement — Per-agent monthly limits with auto-pause

Agent Configuration

MCP Servers Per Agent

{
  "adapterConfig": {
    "mcpServers": {
      "playwright": {
        "command": "node",
        "args": ["/path/to/playwright-mcp/cli.js", "--smart-snapshot"]
      }
    }
  }
}

Cron Schedule

{
  "runtimeConfig": {
    "heartbeat": {
      "schedule": "0 10 * * *",
      "timezone": "America/Los_Angeles"
    }
  }
}

Persistent Agent State

# Read agent's persistent state
GET /api/agents/{id}/state

# Write/merge state
PUT /api/agents/{id}/state
{"topics_covered": ["ai-agents", "browser-automation"]}

Architecture

Slack <-> Slack Bot <-> Clawrp Server (Express + PostgreSQL)
                              |
                      Claude Code processes
                      (--dangerously-skip-permissions)
                      (--resume for sessions)
                      (--mcp-server for tools)

Development

pnpm install       # Install dependencies
pnpm dev           # Start server + UI in dev mode
pnpm build         # Build for production
pnpm test:run      # Run tests