HomeGet Started

Get started with DashClaw

Deploy free, access from anywhere — including your phone. You own the data.

Cloud (recommended)

Vercel + Neon free tiers. Zero cost, accessible from any device, auto-HTTPS. Takes ~10 minutes.

Local

Docker + localhost. Good for development or if you want everything on your machine.

1

Create a free Neon database

Neon gives you a serverless Postgres database on their free tier — no credit card required.

  1. Sign up at neon.tech
  2. Create a new project (any name, e.g. "dashclaw")
  3. Copy the connection string — it looks like postgresql://user:pass@ep-xyz.neon.tech/neondb

You'll paste this as DATABASE_URL in the next step.

2

Deploy to Vercel

Fork the repo and import it into Vercel. Add the environment variables and deploy.

  1. Fork ucsandman/DashClaw to your GitHub account
  2. Go to vercel.com/new and import your fork
  3. Generate your secrets, then paste them into Vercel's environment variables:
About the API key: DASHCLAW_API_KEY is your bootstrap admin key — it authenticates agents and seeds your first organization. After you sign in, you can create and manage additional API keys from the dashboard at /api-keys.

Tables are created automatically on first request.

3

Set up GitHub OAuth

Create a GitHub OAuth app so you can sign in to your dashboard.

  1. Go to GitHub Developer Settings → OAuth Apps → New OAuth App
  2. Set Homepage URL to https://your-app.vercel.app
  3. Set Authorization callback URL to https://your-app.vercel.app/api/auth/callback/github
  4. Copy the Client ID and Client Secret into your Vercel env vars as GITHUB_ID and GITHUB_SECRET
  5. Redeploy from the Vercel dashboard

Replace your-app.vercel.app with your actual Vercel domain.

4

Connect your agents

Agents only need a base URL + API key. Paste these into your agent's environment.

View prompt
Agent environment (example)
DASHCLAW_BASE_URL=https://your-app.vercel.app
DASHCLAW_API_KEY=<your-secret-api-key>
DASHCLAW_AGENT_ID=cinder

Your Vercel app uses Vercel env vars. Your agent uses its own environment variables.

DashClaw Platform Skill

Skills are an open standard for giving agents specialized capabilities. Any agent that supports the skill framework can load this skill and become a DashClaw platform expert: instrumenting agents, scaffolding API routes, generating SDK clients, designing guard policies, troubleshooting errors, and bootstrapping workspaces.

Works with Claude Code, and the growing ecosystem of skill-compatible agents.

What it does

  • Instruments any agent with DashClaw SDKs (Node.js or Python)
  • Designs guard policies for cost ceilings, risk thresholds, and action allowlists
  • Troubleshoots 401, 403, 429, and 503 errors with guided diagnostics
  • Includes validation scripts to verify your integration end-to-end

What's inside

  • SKILL.md — skill definition with 6 guided workflows
  • scripts/validate-integration.mjs — end-to-end connectivity test
  • scripts/diagnose.mjs — 5-phase platform diagnostics
  • references/ — API surface, architecture, and troubleshooting docs

Setup

  1. Download and extract the zip into your project's skills directory (e.g. .claude/skills/ for Claude Code)
  2. Verify the structure:
    dashclaw-platform-intelligence/
    ├── SKILL.md
    ├── scripts/
    │   ├── validate-integration.mjs
    │   ├── diagnose.mjs
    │   └── bootstrap-agent-quick.mjs
    └── references/
        ├── platform-knowledge.md
        ├── api-surface.md
        └── troubleshooting.md
  3. Point your agent at the skill directory and it activates automatically
Download Skill~22 KB · open standard, works with any skill-compatible agent
Alternative: Local Setup

Run locally with Docker

The installer generates secrets, writes .env.local, installs dependencies, and prints the API key your agents should use.

View prompt
Windows (PowerShell)
./install-windows.bat
Mac / Linux (bash)
bash ./install-mac.sh

When it finishes, open http://localhost:3000.

5

Optional: enable verified agents (one-click pairing)

If you want cryptographic identity binding, your agent generates a keypair and prints a one-click pairing URL. You approve once (or approve-all).

Agent environment (verified mode)
# Optional: sign actions with a private key
DASHCLAW_PRIVATE_KEY_PATH=./secrets/cinder-private.jwk

# Optional: server-side enforcement (set on the dashboard host)
ENFORCE_AGENT_SIGNATURES=true

The goal is: no manual public key uploads. Pairing registers the matching public key automatically.