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
pipx install yoru-cli # or: uv tool install yoru-cli
yoru init --server https://yoru.acme.com
Use pipx/uv — a bare pip install yoru-cli fails on Homebrew/Debian Python with
error: externally-managed-environment (PEP 668). No pipx? A venv works too:
python3 -m venv .venv && .venv/bin/pip install yoru-cli.
Yoru is self-hosted — point the CLI at your own backend with --server. yoru init opens a pairing URL in your browser, writes ~/.claude/hooks/yoru.sh, and registers the hook in ~/.claude/settings.json. Don't have a server yet? Stand one up — docker-compose up.
Requires Python 3.10+. One runtime dep: httpx.
Usage
yoru init --server https://yoru.acme.com # pair against your server (--server required)
yoru init --server https://yoru.acme.com --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/TsukumoHQ/yoru. docker-compose up, then yoru init --server https://your-host — done. There is no hosted Yoru; you run it.
License
MIT · Copyright (c) 2026 Yoru authors. Issues and PRs welcome at github.com/TsukumoHQ/cli-yoru.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file yoru_cli-0.2.0.tar.gz.
File metadata
- Download URL: yoru_cli-0.2.0.tar.gz
- Upload date:
- Size: 39.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b41d1c588ed255c25c6d94449f693eb29724729bc09497f5defe38ceec148b18
|
|
| MD5 |
0b13c6e1225b048deba4a3ed5a4a7b83
|
|
| BLAKE2b-256 |
c9bb8e47347b37efaf7546037ff4c9b68731ccba6bbbc47484282fd65ea451b5
|
Provenance
The following attestation bundles were made for yoru_cli-0.2.0.tar.gz:
Publisher:
publish-cli.yml on helios-code/overnight-saas
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
yoru_cli-0.2.0.tar.gz -
Subject digest:
b41d1c588ed255c25c6d94449f693eb29724729bc09497f5defe38ceec148b18 - Sigstore transparency entry: 2022368058
- Sigstore integration time:
-
Permalink:
helios-code/overnight-saas@2632fc459cf2d1de224823d83866f3ae24ebf172 -
Branch / Tag:
refs/tags/cli-v0.2.0 - Owner: https://github.com/helios-code
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-cli.yml@2632fc459cf2d1de224823d83866f3ae24ebf172 -
Trigger Event:
push
-
Statement type:
File details
Details for the file yoru_cli-0.2.0-py3-none-any.whl.
File metadata
- Download URL: yoru_cli-0.2.0-py3-none-any.whl
- Upload date:
- Size: 31.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bcdb40736060fef88da4185cc3a58fe467f2d42a1ecf709308344eec1f545d6f
|
|
| MD5 |
f74416b412d5a73cf725f0577f15590d
|
|
| BLAKE2b-256 |
238fad0b665920c555d963351698dd2bc36a9f2822769e985fd5ca59772be242
|
Provenance
The following attestation bundles were made for yoru_cli-0.2.0-py3-none-any.whl:
Publisher:
publish-cli.yml on helios-code/overnight-saas
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
yoru_cli-0.2.0-py3-none-any.whl -
Subject digest:
bcdb40736060fef88da4185cc3a58fe467f2d42a1ecf709308344eec1f545d6f - Sigstore transparency entry: 2022368127
- Sigstore integration time:
-
Permalink:
helios-code/overnight-saas@2632fc459cf2d1de224823d83866f3ae24ebf172 -
Branch / Tag:
refs/tags/cli-v0.2.0 - Owner: https://github.com/helios-code
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-cli.yml@2632fc459cf2d1de224823d83866f3ae24ebf172 -
Trigger Event:
push
-
Statement type:
