clawrp 0.3.1

package/README.md

@@ -0,0 +1,161 @@
+# Clawrp — The AI Corp
+
+**Self-hosted autonomous AI company platform. Ships with pre-built agents. Runs on your Claude Max plan. Full computer control.**
+
+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
+
+```bash
+npx clawrp onboard
+npx clawrp run
+```
+
+Or from source:
+
+```bash
+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
+
+1. **Create a company** in the dashboard (click "New Company", give it a name and mission)
+
+2. **Set up agent workspaces:**
+   ```bash
+   ./scripts/setup-agents.sh
+   ```
+   This copies agent templates to `~/agents/` (CEO, Researcher, Social Media, Engagement, Analytics).
+
+3. **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)
+
+4. **Invoke the agent** — click "Invoke" on the agent card, or:
+   ```bash
+   curl -X POST http://localhost:3100/api/agents/{agent-id}/wakeup \
+     -H "Content-Type: application/json" \
+     -d '{"source": "on_demand", "reason": "First run"}'
+   ```
+
+5. **Watch it work** — the agent's run appears in the dashboard with live logs.
+
+### Connect Slack (Optional)
+
+1. Create a Slack app using the manifest at `http://localhost:3100/api/onboarding/slack-manifest`
+2. Enable Socket Mode in your Slack app settings
+3. Add environment variables to `.env`:
+   ```
+   SLACK_BOT_TOKEN=xoxb-...
+   SLACK_APP_TOKEN=xapp-...
+   SLACK_SIGNING_SECRET=...
+   CLAWRP_COMPANY_ID=your-company-uuid
+   ```
+4. Restart the server — the Slack bot connects automatically
+5. 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
+
+```json
+{
+  "adapterConfig": {
+    "mcpServers": {
+      "playwright": {
+        "command": "node",
+        "args": ["/path/to/playwright-mcp/cli.js", "--smart-snapshot"]
+      }
+    }
+  }
+}
+```
+
+### Cron Schedule
+
+```json
+{
+  "runtimeConfig": {
+    "heartbeat": {
+      "schedule": "0 10 * * *",
+      "timezone": "America/Los_Angeles"
+    }
+  }
+}
+```
+
+### Persistent Agent State
+
+```bash
+# 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
+
+```bash
+pnpm install       # Install dependencies
+pnpm dev           # Start server + UI in dev mode
+pnpm build         # Build for production
+pnpm test:run      # Run tests
+```
+
+## License
+
+Proprietary. Copyright (c) 2026 Firefloco, Inc. See [LICENSE](LICENSE) for details.