Install OverClaw CLI

Prerequisites

• •Bun runtime (v1.0+)
• •Git

Install from source

git clone https://github.com/Tmeister/overclaw-cli.git
cd overclaw-cli
bun install

Option A: Link for development

Makes the overclaw command available globally via symlink. Requires Bun on the host.

bun link

Verify:

overclaw --help

Option B: Compile to standalone binary

Produces a single binary with no runtime dependency. Best for servers and production.

bun build --compile src/main.ts --outfile overclaw

Move the binary somewhere in your PATH:

mv overclaw /usr/local/bin/overclaw

Verify:

overclaw --help

Configuration

The CLI needs two environment variables: SUPABASE_URL and SUPABASE_ANON_KEY.

Option 1: .env.local file

Create a .env.local file next to the binary or in the project root:

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_ANON_KEY=your-anon-key

Option 2: Environment variables

Export them directly:

export SUPABASE_URL=https://your-project.supabase.co
export SUPABASE_ANON_KEY=your-anon-key

Verify the setup

Run the init command to check that the CLI can reach the database and all tables exist:

overclaw init

Expected response:

{ "ok": true, "resource": "init", "tables": { "settings": true, "projects": true, "tasks": true, "agents": true, "comments": true, "activities": true, "documents": true }, "missing": [] }

If any table shows false, run the migration SQL from the repo's supabase-migration.sql in your Supabase SQL Editor.

Troubleshooting