commitlydocs
← back to home
watch

commitly-agent observe

Sign every save with Ed25519 and ship the proof.

commitly-agent observe <projectPath> [--flush-interval <ms>] [--flush-size <n>]

## description

Watches every file write in the project (via chokidar), computes a sha256, and emits a JSON envelope signed with this machine's Ed25519 key. Envelopes are spooled to ~/.commitly/attestations.ndjson and flushed to the dashboard in batches. Crash-safe — on restart, the spool is replayed before new events are accepted.

## flags

flagdescription
--flush-interval <ms>
Maximum time between batch flushes. (default: 10000)
--flush-size <n>
Maximum number of attestations per batch. (default: 50)

## example

$ commitly-agent observe ~/code/api

→ Observing ~/code/api
   flushInterval=10000ms flushSize=50 device=8f3a2c5b…
   Signing every save with Ed25519 → https://commitly.dev/api/agent/attestations

[14:02:11] sig:ed25519  src/lib/db.ts          (+18 −2)
[14:02:34] sig:ed25519  src/routes/auth.ts     (+6  −0)
→ Flushed 4 attestation(s) → accepted 4, rejected 0

## notes

See the full command reference, or jump to Daemon mode if you plan to run this unattended.