How jj-vcs/jj works
Jujutsu is a command-line version control system whose user-facing model centers on commits, automatically snapshotted working copies, history rewriting, and reversible operations. The principal workflow is to invoke jj commands to inspect or modify a repository, with changes represented as commits and stored through a backend; Git is the current storage layer and provides interoperability. The graph preserves documented query, conflict, and operation-history capabilities. Source excerpts are partial, so several domain relationships rely on README-level documentation rather than inspected call sites.
Main entry points: working_copy.rs Working copy · revset.rs Revset evaluation · store.rs Object store · git_backend.rs Git backend
Components 18
CLI
- jj entry
cli/src/main.rs - Command dispatch
cli/src/commands/mod.rs - CLI runtime
cli/src/cli_util.rs - UI and formatting
cli/src/ui.rs
Version Control
- Working copy
lib/src/working_copy.rs - Workspace
lib/src/workspace.rs - History rewriting
lib/src/rewrite.rs - Commit evolution
lib/src/evolution.rs - Operation history
core/src/operation.rs - Commit model
core/src/commit.rs
History and Queries
- Revset evaluation
lib/src/revset.rs - Revset parsing
dsl/src/revset_parser.rs - Commit index
default-index/src/composite.rs
Storage
- Object store
core/src/store.rs - Backend interface
core/src/backend.rs - Git backend
git-backend/src/git_backend.rs
Other components
- Repository user
- Git repository
Connections 19
- Repository user → jj entry: runs commands
README.md - jj entry → Command dispatch: dispatches
- Repository user → Working copy: edits files
README.md - Working copy → Commit model: snapshots changes
README.md - Repository user → History rewriting: rewrites history
README.md - History rewriting → Commit evolution: rebases descendants
README.md - Repository user → Operation history: views or undoes
README.md - Repository user → Revset evaluation: selects commits
README.md - Revset parsing → Revset evaluation: parses expressions
dsl/src/revset_parser.rs - Revset evaluation → Commit index: queries commits
- Commit model → Object store: loads commit data
core/src/commit.rs - Object store → Backend interface: delegates storage
core/src/store.rs - Git backend → Backend interface: implements interface
git-backend/src/git_backend.rs - Git backend → Git repository: stores Git objects
README.md - Repository user → Git repository: publishes changes
README.md - Command dispatch → CLI runtime: uses runtime
cli/src/cli_util.rs - CLI runtime → UI and formatting: formats output
cli/src/cli_util.rs - Workspace → Working copy: manages checkout
- Operation history → Object store: persists operations