Point kugutsu at a ticket queue, an inbox, a schedule or a webhook. It picks up what arrives, does the work with the models you choose, and hands you the result to approve, within the budget and the permissions you set.
A kugutsu graph keeps running on your machine. Events reach the models, the models do the work, and what matters waits for you.
Declared in the graph or for the whole machine, per day or per run. Once spent, no node starts another step.
A file written, a request made, a command run through kugutsu: each is granted to a node and checked before it runs. An agent session acts on its own, inside the boundary you set for it: files, network, commands, CPU and memory, sandboxed.
Watch messages move through the running graph, replay past runs, and test a changed graph against them before it goes live.
That is the hard question, and your own coding agent can answer it better than a list of examples. Two hand-offs, each one line to paste into Claude Code, Codex or another agent.
Read https://kugutsu.io/discover.md and follow it.mkdir -p ~/.claude/skills/kugutsu-discover && curl -fsSL https://kugutsu.io/discover.md -o ~/.claude/skills/kugutsu-discover/SKILL.mdThen run /kugutsu-discover.
It only reads, through scripts that print short, masked excerpts, and writes nothing but the report. What it reads is seen by your agent's model, as in any session with it, so strike what your employer would not allow. The report names no company, person, project or link, and you approve it before you share it.
Read https://kugutsu.io/setup.md, set up kugutsu, and build the first pick from kugutsu-discovery-report.md.Linux, macOS on Apple silicon, or Windows through WSL. Needs Node.js 24 and a signed-in Claude Code or Codex. The repository is private during early access: setup needs a GitHub account with access, which the waitlist gives out.
kugutsu is in early access. Leave your email, and your GitHub username if you want access to the repository; we add people in the order their work fits.
| If you need | Use | kugutsu instead when |
|---|---|---|
| An agent inside your app, where each run starts with a request and ends with an answer | LangGraph, CrewAI, an agent SDK | agents should keep running, react to events, and change without a redeploy |
| Integrations with hundreds of SaaS apps, with a few LLM steps | n8n, Node-RED, Dify | the model loops are the point, and need hop limits, budgets, reviews and replay |
| One agent on one schedule | Claude Code with cron and a script | you have several agents, triggers or models, and want to see and replay what they did |