Operate

The basics of running Takosumi yourself: what to prepare before a change, and where to look. The detailed runbooks live in docs/operations/ in the repository.

Before you change a production installation

1. The target commit and the digest of the artifact built from it.
2. The database migration plan and a backup.
3. The endpoints to check after deploying, and what you expect.
4. A rollback path. If the change cannot be rolled back, a forward-repair plan.
5. Independent review when the change touches secrets, authentication, billing, or data deletion.

The repository-wide gate is bun run check; the deploy contract is bun run deploy -- --contract. Deploy only after reading both and the relevant runbook.

Where to look

• Operator control MCP — operational entry point
• Run model — reading Runs and records

Next

• Run it yourself — set up an installation
• Product boundaries — what Takosumi owns and does not