Skip to content

quickstart.md

Latest commit

 

History

History
80 lines (52 loc) · 1.68 KB

quickstart.md

File metadata and controls

80 lines (52 loc) · 1.68 KB

Quickstart (Operators)

This quickstart is for operating a self-hosted Claw daemon with production-minded defaults.

1) Install and verify

Install claw from releases, then verify:

claw --version

2) Initialize repository metadata

In your repository root:

claw init

This creates .claw/ and prepares local object storage.

3) Set an integration policy baseline

Example policy requiring test and lint evidence:

claw policy create \
  --id default \
  --visibility public \
  --check test \
  --check lint \
  --reviewer release-bot \
  --min-trust-score 0.8

4) Prepare daemon auth token

Store a token in a profile used by daemon startup:

claw auth token set "<strong-random-token>" --profile default

5) Preflight checks

Run preflight before exposing the service:

claw admin preflight

Expected output starts with Preflight: PASS.

6) Start daemon

Example localhost start for validation:

claw daemon --listen 127.0.0.1:50051 --auth-profile default

For production, run under a supervisor (for example systemd) and bind to your service interface.

7) Register remote from a client repo

From a client/consumer repository:

claw remote add origin http://claw-daemon.internal:50051 --kind grpc --token-profile default
claw sync pull --remote origin --ref-name heads/main

If heads/main does not yet exist remotely, transport/auth is still validated when you get Remote ref heads/main not found.

Next docs