crabot

Local-first AI agent runtime with a gateway, operator console, and CLI.

Requirements

crabot is a self-contained standalone binary with the runtime embedded — it needs no Bun or Node install. The package bundles the binary directly (a small Node launcher execs it), so installing it downloads nothing extra and runs no install scripts.

Currently macOS arm64 only. Other platforms are not yet published; build from source at the repository. A macOS arm64 binary is also attached to each GitHub release for direct download.

Install

npm install -g crabot
# or with bun
bun install -g crabot
# run once without installing
npx crabot --version

Usage

crabot serve              # start the gateway, HTTP API, SSE, and web console
crabot setup              # first-run setup
crabot doctor             # diagnose the local environment
crabot chat "<message>"   # send a one-off chat message
crabot update status      # show installed surfaces and versions

Run crabot with an unknown command to print the full command list.

State and configuration

Crabot stores operational state under data/ and the agent workspace under workspace/, relative to the current working directory. Override the locations with CRABOT_DATA_DIR and CRABOT_WORKSPACE_DIR.

The server binds 127.0.0.1:3000 by default. Set HOST and PORT to change the bind address; set HOST=0.0.0.0 to expose the daemon to other machines.

License

MIT