Pijul patch-based VCS with categorical patch theory for skill versioning
/plugin marketplace add plurigrid/asi/plugin install asi-skills@asi-skillsThis skill inherits all available tools. When active, it can use any tool Claude has access to.
Patch-based version control with mathematically sound commutative patch theory.
Trit: -1 (MINUS) - Validator role for patch verification and merge correctness
Pijul is a distributed VCS where patches are first-class citizens that commute when independent. This maps directly to:
# Using flox CLI
flox install pijul
# Via MCP (flox_install tool)
{"name": "flox_install", "arguments": {"package": "pijul"}}
# Initialize
pijul init
# Clone (partial clone supported!)
pijul clone https://nest.pijul.com/user/repo
pijul clone --partial https://nest.pijul.com/user/repo # sparse clone
# Record changes (creates patch)
pijul record -m "Add feature"
# Push/Pull
pijul push
pijul pull
# List patches (changes)
pijul log
# Show patch contents
pijul diff
# Apply specific patch
pijul apply <hash>
# Unapply (revert) patch
pijul unrecord <hash>
# Fork (branch)
pijul fork <name>
# Switch channel (branch)
pijul channel switch <name>
# Partial clone - only fetch needed patches
pijul clone --partial <url>
# Fetch specific patches
pijul pull --from-channel <channel>
# Lazy evaluation - patches fetched on demand
pijul reset --lazy
State_A --patch_1--> State_B --patch_2--> State_C
If patch_1 ⊥ patch_2 (independent):
patch_1 ; patch_2 = patch_2 ; patch_1
State_A
/ \
p_1 p_2
/ \
State_B State_C
\ /
p_2' p_1'
\ /
State_D (pushout)
When patches are independent, their pushout is unique and well-defined.
trit == -1 or +1: Store as morphism (patch)
- No materialization
- Lazy evaluation
- Minimal storage
trit == 0: Force materialization
- Coordination point
- Full state snapshot
- Archive checkpoint
--materialize flag explicittrit == 0 (ERGODIC coordination)cd .agents/skills/my-skill
pijul record -m "Add GF(3) frontmatter"
# Sparse pull - only new patches
pijul pull --partial
# Check for conflicts
pijul log --pending
pijul fork experiment
pijul channel switch experiment
# ... make changes ...
pijul record -m "Experimental patch"
# Merge back if successful
pijul channel switch main
pijul pull --from-channel experiment
# manifest.toml
[install]
pijul.pkg-path = "pijul"
flox activate
pijul --version
{
"name": "flox_install",
"arguments": {"package": "pijul"}
}
pijul (-1) + flox-mcp (0) + skill-creator (+1) = 0 ✓
Validator Coordinator Generator
Pijul validates patch correctness, flox-mcp coordinates environment, skill-creator generates new skills.