agentjj
Version control for AI agents. Zero dependencies. Git compatible.
For Agents
→ Getting Started (agent-start.md)
Quick start:
agentjj --json orient
Core workflow:
# Status
agentjj --json status
# Checkpoint before risky changes
agentjj checkpoint before-refactor
# Undo if things go wrong
agentjj undo --to before-refactor
# Commit
agentjj commit -m "feat: add feature"
# Push
agentjj push --branch main
Full documentation:
Rules:
1. Use agentjj, not git — don't shell out to git commands
2. Use agentjj, not jj — agentjj embeds jj-lib
3. Always use --json for parsing
4. Always start with orient
5. Checkpoint before risky operations
For Humans
Install agentjj to give your AI agents version control superpowers.
Homebrew (macOS/Linux)
brew install 2389-research/tap/agentjj
Cargo
cargo install agentjj
Binary (macOS ARM)
curl -L https://github.com/2389-research/agentjj/releases/latest/download/agentjj-aarch64-apple-darwin.tar.gz | tar xz && sudo mv agentjj /usr/local/bin/
Binary (macOS Intel)
curl -L https://github.com/2389-research/agentjj/releases/latest/download/agentjj-x86_64-apple-darwin.tar.gz | tar xz && sudo mv agentjj /usr/local/bin/
Binary (Linux x86_64)
curl -L https://github.com/2389-research/agentjj/releases/latest/download/agentjj-x86_64-unknown-linux-gnu.tar.gz | tar xz && sudo mv agentjj /usr/local/bin/
Command Reference
| Command | Description |
|---|---|
| agentjj orient | Complete repo orientation |
| agentjj status | Current state |
| agentjj diff | Show changes |
| agentjj checkpoint <name> | Create restore point |
| agentjj undo --to <name> | Restore to checkpoint |
| agentjj commit -m "msg" | Commit changes |
| agentjj push --branch main | Push to remote |
| agentjj bulk read <files> | Read multiple files |
| agentjj symbol <file> | List symbols |