boid

README

boid

A personal AI orchestrator (Linux only). Track each request, from kickoff to a finished artifact, as a single task and hand it to an AI agent. The agent reads and writes your local filesystem directly, so it can use the tools and environment you already have. Writes are confined to a sandbox-bounded scope, so a runaway agent cannot damage the rest of your machine.

日本語 README

Features

• Use the tools you already installed. Hand the agent your local Claude Code, Codex, git, gh, editors, and language toolchains. Cloud-side agent sandboxes can't touch your real environment; this one does.
• Up and running in two commands. go install, then boid start. No config file, no server provisioning, no signup.
• The task model is built in. Request → execute → done, with the data captured at each step pre-defined. You don't have to re-explain context every time you reopen a task with new instructions.
• Bound the write scope with a sandbox. The agent reads your real directories directly, but its writes are confined to a scope you choose (typically a git worktree). A runaway agent cannot reach your home directory or other projects.
• Run several requests in parallel. You can give each task its own git worktree, so concurrent jobs run on separate branches in separate directories without colliding.
• Extensions are swappable packages. Pick which AI agent (Claude Code, Codex), which CI integration, which PR / auto-merge flow — the building blocks live in separate packages such as boid-kits.
• Drive it from the terminal or a browser. TUI and CLI for everyday use; expose the Web UI through Cloudflare Tunnel to drive it from your phone.

Install

go install github.com/novshi-tech/boid@latest

Quickstart

boid start              # start the daemon (auto-detached)
boid task list          # list tasks
boid task show <id>     # inspect a task
boid stop               # stop the daemon

A guided walkthrough lives in docs/en/getting-started/01-install.md.

Documentation

• Install and quickstart
• Concepts — vocabulary
• State machine — including the awaiting state for C2 Q&A
• C2 flow — non-interactive sessions + Q&A architecture
• Web UI — including Cloudflare Tunnel setup
• Troubleshooting

The full doc index is at docs/en/. Japanese docs are at docs/ja/.

Status

Currently being evaluated within the scope the author can directly support. A wider public release will follow.

License

MIT.