agentic-jujutsu
Quantum-resistant, self-learning version control for AI agents with ReasoningBank intelligence and multi-agent coordination
By ruvnet · 1,166 installs
npx skills add ruvnet/ruflo --skill agentic-jujutsu
Source repository · Upstream listing
Agentic Jujutsu AI Agent Version Control
Quantum ready, self learning version control designed for multiple AI agents working simultaneously without conflicts.
When to Use This Skill
Use agentic jujutsu when you need:
✅ Multiple AI agents modifying code simultaneously
✅ Lock free version control (23x faster than Git)
✅ Self learning AI that improves from experience
✅ Quantum resistant security for future proof protection
✅ Automatic conflict resolution (87% success rate)
✅ Pattern recognition and intelligent suggestions
✅ Multi agent coordination without blocking
Quick Start
Installation
Basic Usage
Core Capabilities
1. Self Learning with ReasoningBank
Track operations, learn patterns, and get intelligent suggestions:
Validation (v2.3.1) :
✅ Tasks must be non empty (max 10KB)
✅ Success scores must be 0.0 1.0
✅ Must have operations before finalizing
✅ Contexts cannot be empty
2. Pattern Discovery
Automatically identify successful operation sequences:
3. Learning Statistics
Track improvement over time:
4. Multi Agent Coordination
Multiple agents work concurrently without conflicts:
5. Quantum Resistant Security (v2.3.0+)
Fast integrity verification with quantum resistant cryptography:
6. Operation Tracking with AgentDB
Automatic tracking of all operations:
Advanced Use Cases
Use Case 1: Adaptive Workflow Optimization
Learn and improve deployment workflows:
Use Case 2: Multi Agent Code Review
Coordinate review across multiple agents:
Use Case 3: Error Pattern Detection
Learn from failures to prevent future issues:
Use Case 4: Continuous Learning Loop
Implement a self improving agent:
API Reference
Core Methods
Method Description Returns
new JjWrapper() Create wrapper instance JjWrapper
status() Get repository status Promise<JjResult
newCommit(msg) Create new commit Promise<JjResult
log(limit) Show commit history Promise<JjCommit[]
diff(from, to) Show differences Promise<JjDiff
branchCreate(name, rev?) Create branch Promise<JjResult
rebase(source, dest) Rebase commits Promise<JjResult
ReasoningBank Methods
Method Description Returns
startTrajectory(task) Begin learning trajectory string (trajectory ID)
addToTrajectory() Add recent operations void
finalizeTrajectory(score, critique?) Complete trajectory (score: 0.0 1.0) void
getSuggestion(task) Get AI recommendation JSON: DecisionSuggestion
getLearningStats() Get learning metrics JSON: LearningStats
getPatterns() Get discovered patterns JSON: Pattern[]
queryTrajectories(task, limit) Find similar trajectories JSON: Trajectory[]
resetLearning() Clear learned data void
AgentDB Methods
Method Description Returns
getStats() Get operation statistics JSON: Stats
getOperations(limit) Get recent operations JjOperation[]
getUserOperations(limit) Get user operations only JjOperation[]
clearLog() Clear operation log void
Quantum Security Methods (v2.3.0+)
Method Description Returns
generateQuantumFingerprint(data) Generate SHA3 512 fingerprint Buffer (64 bytes)
verifyQuantumFingerprint(data, fp) Verify fingerprint boolean
enableEncryption(key, pubKey?) Enable HQC 128 encryption void
disableEncryption() Disable encryption void
isEncryptionEnabled() Check encryption status boolean
Performance Characteristics
Metric Git Agentic Jujutsu
Concurrent commits 15 ops/s 350 ops/s (23x)
Context switching 500 1000ms 50 100ms (10x)
Conflict resolution 30 40% auto 87% auto (2.5x)
Lock waiting 50 min/day 0 min (∞)
Quantum fingerprints N/A <1ms
Best Practices
1. Trajectory Management
2. Pattern Recognition
3. Multi Agent Coordination
4. Error Handling
Validation Rules (v2.3.1+)
Task Description
✅ Cannot be empty or whitespace only
✅ Maximum length: 10,000 bytes
✅ Automatically trimmed
Success Score
✅ Must be finite (not NaN or Infinity)
✅ Must be between 0.0 and 1.0 (inclusive)
Operations
✅ Must have at least one operation before finalizing
Context
✅ Cannot be empty
✅ Keys cannot be empty or whitespace only
✅ Keys max 1,000 bytes, values max 10,000 bytes
Troubleshooting
Issue: Low Confidence Suggestions
Issue: Validation Errors
Issue: No Patterns Discovered
Examples
Example 1: Simple Learning Workflow
Example 2: Multi Agent Swarm
Related Documentation
NPM Package : https://npmjs.com/package/agentic jujutsu
GitHub : https://github.com/ruvnet/agentic flow/tree/main/packages/agentic jujutsu
Full README : See package README.md
Validation Guide : docs/VALIDATION FIXES v2.3.1.md
AgentDB Guide : docs/AGENTDB GUIDE.md
Version History
v2.3.2 Documentation updates
v2.3.1 Validation fixes for ReasoningBank
v2.3.0 Quantum resistant security with @qudag/napi core
v2.1.0 Self learning AI with ReasoningBank
v2.0.0 Zero dependency installation with embedded jj binary
Status : ✅ Production Ready
License : MIT
Maintained : Active