DON'T PANIC Fully local Explicit control Auditable

A robot that lives on your computer.

Meet Robot: your personal assistant for automation, right where you need it—on your own machine. It’s smart, reliable, and built to help without sneaking around behind your back.

  • Safety-first automation with explicit consent.
  • Transparent operations you can audit and understand.
  • Local by default — your data stays on your computer.
  • Minimal permissions and clear boundaries.

Nothing runs without your say-so. Your machine, your rules.

Deterministic automation, not a black box.

Robot executes a sequential action stream (usually NDJSON). You can preview, constrain, and replay the same edits — with an evidence bundle that captures exactly what happened.

Input
NDJSON actions
Guards
allowlisted roots optional green gate
Output
results stream evidence bundle
actions.ndjson
{"op":"read","path":"README.md"}
{"op":"patch","path":"src/pages/index.astro","diff":"..."}
{"op":"run","cmd":"npm test","when":"green-gate"}
{"op":"task:done"}
One JSON object per line. Easy to audit. Easy to replay.

Guardrails you control

Robot doesn’t assume “full access”. You explicitly choose what it can touch and which capabilities are enabled.

Filesystem
--allow-root
Edits are constrained to allowlisted roots under your work directory.
Green gate
--tests auto
Optionally require tests to pass before marking work as done.
Network
--net off
Networking is disabled by default. Enable it only when you choose.
Exec
--exec off
Direct argv execution is opt‑in. Turn it on per run or keep it locked down.

Evidence, on by default

Each run can write an evidence bundle: actions, results, metadata, and best‑effort git capture — designed for review and peace of mind.

.robot/evidence/RUN-*
run.json
actions.ndjson
results.ndjson
evidence.ndjson
proofs.json
git/
  head.txt
  status.porcelain.txt
  diff.patch

Work the way you like

Paste‑driven, AI‑assisted, file‑queued, or cooperative — without changing the safety model.

setup
Zero‑config wizard: detect tests, choose roots, and verify with doctor.
loop
Paste‑driven iteration: feed actions, review results, repeat — deterministic and logged.
auto
AI‑driven loop with the same guardrails (allowlists, optional green gate, evidence).
belt
Cooperative queues for teams: inbox/working/done with optional policy.