Skip to content
basou

basou

Provenance layer for AI development.
View on GitHub View on npm

What is basou?

Section titled “What is basou?”

basou records what AI coding agents do — sessions, decisions, approvals, git snapshots, and command output — into a structured, replayable trail that lives next to your code.

  • JSONL as the source of truth. Every observable event (command run, file changed, decision recorded, approval resolved) is appended to .basou/sessions/<session_id>/events.jsonl.
  • Markdown as the human view. .basou/handoff.md and .basou/decisions.md are regenerated from the event log and may be hand-edited; both forms can be reviewed in any text editor or PR.
  • Tasks as the goal unit. A task may span multiple sessions; the task.md snapshot stays in sync with the event log.
  • Claude Code as the beachhead adapter. basou run claude-code wraps the process so the surrounding session is recorded without basou knowing about Anthropic-internal formats.

Install

Section titled “Install”
Terminal window
npm install -g @basou/cli

Then run basou init at the root of any git repository to start an audit-trailed session.

Status

Section titled “Status”

basou is at v0.3.0 (2026-05-21) — dogfood-ready, pre-OSS-publish-stable. The CLI surface is frozen for v0.3.x; internal @basou/core APIs may still change between minor releases.

Source lives at github.com/basou-dev/basou. Published scoped packages: @basou/core, @basou/cli, @basou/sdk.