phreakocious

Symbion — Git skill for Claude Code

Git community

A notebook and ticket registry for agents: dated rows attached to a commit, a file, an item, an arc or the project, kept in a sibling git repo of JSONL.

How to install Symbion

This entry records only its repository, not the path inside it, so there is no exact command to give. Open phreakocious/symbion and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Symbion does

A notebook and ticket registry for agents: dated rows attached to a commit, a file, an item, an arc or the project, kept in a sibling git repo of JSONL.

Alternatives in Git

Commit Commands — Git commit workflows: commit, push, and PR creation 14k ★
Commit Compact — Create a git commit 2k ★
Get Commit Details — git show --name-status [COMMIT_ID] git diff [COMMIT_ID]^ [COMMIT_ID] 1.3k ★

README

symbion

A per-project notebook and ticket registry for small projects, driven by a human and a coding agent through one CLI. The CLI works on its own; the agent surface (a skill and a SessionStart hook) is written for Claude Code.

A note is dated, attributed, retractable, and attached to something stable: a commit, a file, a free-form item, or the project as a whole. Seven kinds by default — `check` (a dated verification), `decision` (an ADR), `bug` (known broken), `task` (a next action), `question` (needs the owner's answer), `idea` (parked), `note` (everything else) — and a project may declare its own labels in `symbion.toml` under `[kinds]`; every kind is a label on three bits (`status`, `parked`, `verdict`), and `symbion schema` prints the table. An **arc** is a named line of work — an epic, if you like — rendered as a per-object checklist with its decisions and notes filed under it. The store is a private sibling git repo of JSONL, so checking out an old branch never time-travels your tickets.

Design and rationale: [`docs/superpowers/specs/2026-09-04-symbion-design.md`](https://github.com/phreakocious/symbion/blob/main/docs/superpowers/specs/2026-09-04-symbion-design.md). The agent-facing surface, which is also the best command reference: `src/symbion/data/skill/SKILL.md` (linked at `~/.claude/skills/symbion`).

Install

Python 3.11+ and git. The core needs two packages, `rich` and `rich-argparse`, for a person at a terminal: `list`, `show` and `context` as aligned, coloured columns with bodies rendered as markdown, and every other command and `--help` in the same colours. A pipe gets plain text. One optional extra, `gui`, adds the web UI (`symbion serve`):

pipx install 'symbion[gui]'
# or: uv tool install 'symbion[gui]'
# drop [gui] for the core alone; for the unreleased main branch:
# pipx install 'symbion[gui] @ git+https://github.com/phreakocious/symbion'

To work on symbion itself, install a clone editable: