yoru-cli 0.1.1

Yoru — audit-grade session receipts for autonomous AI coding agents.

yoru-cli

The Claude Code hook installer for Yoru. One command installs a PostToolUse hook that forwards every tool call, file edit, and red-flag event to a Yoru backend. Your next session shows up in the dashboard automatically.

Install

pip install yoru-cli
yoru init

yoru init opens a pairing URL in your browser, writes ~/.claude/hooks/yoru.sh, and registers the hook in ~/.claude/settings.json. By default it points at Yoru Cloud (yoru.sh) — free forever for one developer.

Requires Python 3.10+. One runtime dep: httpx.

Usage

yoru init                               # pair against https://api.yoru.sh
yoru init --server https://yoru.acme    # pair against your self-hosted server
yoru init --token yoru_xxx --force      # non-interactive (CI / scripted rotation)

yoru tail < events.jsonl                # post a batch of events (debug)

yoru --version
yoru --help

Exit codes: 0 ok · 1 already installed (use --force) · 2 auth failed · 3 4xx · 4 5xx/network.

How the hook works

The installed script is ~20 lines of Bash that POSTs one JSON event per Claude Code tool call:

{"session_id": "…", "user": "…", "kind": "tool_use", "tool": "Bash", "content": "…"}

It uses curl --max-time 2 || true so a Yoru outage never stalls your terminal — Claude Code doesn't notice the hook is even there.

Self-host the server

The CLI is MIT. The server (backend + dashboard) is AGPL-3.0 and lives at github.com/yoru-sh/yoru. docker-compose up, then yoru init --server https://your-host — done.

License

MIT · Copyright (c) 2026 Yoru authors. Issues and PRs welcome at github.com/yoru-sh/cli.