Brainrot — AI Workspace

A lightweight collaborative AI workspace: workspaces hold projects; projects hold parallel task cards; users @mention self-hosted Claude Code agents inside each task card's conversation flow.

Quick start

1. Bring up Postgres: ./scripts/db-up.sh
2. Apply migrations: ./scripts/migrate.sh up
3. Run the server: go run ./cmd/server
4. Register, create a workspace, mint an install token via the API, then run the daemon:

   go run ./cmd/daemon --register <TOKEN> --server http://localhost:8080 --name dev
   go run ./cmd/daemon
   

Layout

See ARCHITECTURE.md.

Tests

• Unit / fast: go test -short ./...
• Integration (needs Docker): go test -tags=integration ./...
• E2E: go test -tags=e2e ./test/e2e/...
• Real claude CLI: go test -tags=claude_cli ./internal/daemon/backend/claude/...

Design docs

• Spec: docs/superpowers/specs/2026-05-13-brainrot-ai-workspace-design.md
• Plan: docs/superpowers/plans/2026-05-13-brainrot-ai-workspace.md