Skip to content

Get-Real-XR/agent-plugins

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

agent-plugins

Claude Code plugins for Diderot. Your agent writes change descriptions, enforces conventional commits, teaches you jj as you work, and isolates worktrees via jj workspaces.

Quick Start

Add the marketplace:

claude plugin marketplace add get-real-xr/agent-plugins

Install plugins:

claude plugin install active-descriptions@agent-plugins
claude plugin install conventional-commits@agent-plugins
claude plugin install jj-tutor@agent-plugins
claude plugin install jj-worktree-compat@agent-plugins

All four work together but can be installed independently.

Plugins

active-descriptions

Keeps your jj change descriptions in sync with your actual changes.

Install claude plugin install active-descriptions@agent-plugins
Skill /describe (user-invocable)
Requires jj, Rust toolchain (cargo)

Blocks session exit until every in-flight change has an up-to-date description. When the agent detects drift, it runs /describe — reading the diff and conversation history, drafting a Conventional Commits description, and applying it via jj describe. Also gates Bash commands on being inside a jj repository.

Invoke /describe manually at any time to co-author a description mid-session.

conventional-commits

Formats all change descriptions to the Conventional Commits v1.0.0 spec.

Install claude plugin install conventional-commits@agent-plugins
Skill agent context (loaded automatically)
Requires

Every description the agent writes follows the type[scope][!]: description structure. Works standalone or as the formatting layer for /describe.

jj-tutor

Teaches you jj at your own pace.

Install claude plugin install jj-tutor@agent-plugins
Skill agent context (loaded automatically)
Requires jj

Asks your VCS experience level on first use (five tiers, from "brand new to the terminal" through "pre-existing jj user"), then adapts explanation depth, Git comparisons, confirmation thresholds, and vocabulary introduction to match. Tracks per-command and per-concept familiarity across sessions and backs off as you demonstrate comfort.

jj-worktree-compat

Routes Claude Code worktree isolation through jj workspaces.

Install claude plugin install jj-worktree-compat@agent-plugins
Requires jj

Creates a jj workspace sharing the same parents as your current working copy; cleans up automatically on removal. Drop-in replacement for Claude Code's built-in git worktrees.

How the jj plugins work together

  • active-descriptions enforces that every session ends with up-to-date descriptions, using conventional-commits for formatting. /describe ties them together.
  • jj-worktree-compat handles workspace lifecycle independently, so agent isolation works natively with jj.
  • jj-tutor adapts to your level regardless of what else is installed — no coupling to the other plugins.

Prerequisites

Plugin jj Rust toolchain
active-descriptions required required
conventional-commits
jj-tutor required
jj-worktree-compat required

Install jj: jj-vcs.github.io/jj/latest/install-and-setup Install Rust: rustup.rs

About

Claude Code plugins for jj (Jujutsu) VCS workflows

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors