Bithyle Documentation

Bithyle is a personal code forge built natively around jj's change model. Changes are first-class: stable IDs survive rebases, and the full change graph is visible in the web UI.

Guides

• Getting Started -- Install the CLI, authenticate, and push your first repository.
• CLI Reference -- All commands and options.
• CI Runner -- Register and operate self-hosted CI runners.
• Pipeline Reference -- Define CI pipelines in .forge/pipeline.toml.

Key Concepts

Change IDs -- Every commit carries a stable change ID (stored in a Change-Id git header). Unlike commit hashes, change IDs survive rebases, so Bithyle can track a change across its entire lifecycle.

Change Graphs -- When you push a branch with multiple commits, Bithyle groups them into a change graph. The graph preserves parent/child relationships and is displayed as a DAG in the UI.

Merge Queue -- Instead of manual merges, enqueue a change graph. Bithyle rebases it onto trunk, runs CI, and fast-forwards the bookmark on success.

Namespaces -- Users and teams each get a namespace. Repositories live under namespaces (namespace/repo). Teams can have multiple members with shared access.