Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

Refine plugin description and add examples for marketplace

Maximilian Roosd2bae9f0f89c
diff --git a/.claude-plugin/README.md b/.claude-plugin/README.md
new file mode 100644
index 000000000..d7858a333
--- /dev/null
+++ b/.claude-plugin/README.md
@@ -0,0 +1,24 @@
+# Worktrunk Plugin for Claude Code
+
+Git worktree management CLI integration with activity tracking.
+
+## Features
+
+1. **Configuration skill** — Guides LLM-powered commit message setup, project hooks (post-create, pre-merge), and worktree path customization
+2. **Activity tracking** — Shows which branches have active Claude sessions via indicators in `wt list`
+
+## Examples
+
+**Activity tracking across worktrees**
+
+The plugin installs Claude Code hooks that track session activity per branch. When a prompt is submitted, the hook sets 🤖 on that branch. When Claude finishes and waits for input, it switches to 💬. When the session ends, the marker clears.
+
+These markers appear in `wt list` output, making it easy to see which worktrees have active Claude sessions — useful when running multiple instances in parallel.
+
+**Set up LLM for commit message generation**
+
+The configuration skill guides through installing the `llm` CLI tool, setting API keys, and adding `[commit-generation]` to the user config so `wt merge` can auto-generate commit messages.
+
+**Add post-create hooks to run npm install automatically**
+
+The skill configures `.config/wt.toml` with project hooks. Post-create hooks run when creating worktrees, pre-merge hooks validate before merging.
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index 4afbeed82..7118fac7b 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -11,7 +11,7 @@
"plugins": [
{
"name": "worktrunk",
- "description": "Complete Worktrunk integration for Claude Code. Provides: (1) configuration skill for setting up LLM integration, project hooks, and worktree automation, (2) automatic hooks that track AI activity per branch (🤖💬 indicators in wt list). Use when configuring Worktrunk, setting up hooks, or wanting visibility into which branches have active Claude sessions.",
+ "description": "Worktrunk is a git worktree management CLI that streamlines multi-branch development. This plugin provides Claude Code integration with two features: (1) A configuration skill guiding you through LLM-powered commit message generation, project automation hooks (post-create, pre-merge), and worktree path customization. (2) Automatic activity tracking that displays 🤖 (working) and 💬 (waiting) indicators in `wt list`, showing which branches have active Claude sessions. Use when setting up Worktrunk configuration, automating project workflows, or monitoring AI activity across branches.",
"source": "./.claude-plugin",
"strict": false,
"skills": [
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 46b152a57..f68cad3d1 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
{
"name": "worktrunk",
- "description": "Complete Worktrunk integration for Claude Code. Provides: (1) configuration skill for setting up LLM integration, project hooks, and worktree automation, (2) automatic hooks that track AI activity per branch (🤖💬 indicators in wt list). Use when configuring Worktrunk, setting up hooks, or wanting visibility into which branches have active Claude sessions.",
+ "description": "Worktrunk is a git worktree management CLI that streamlines multi-branch development. This plugin provides Claude Code integration with two features: (1) A configuration skill guiding you through LLM-powered commit message generation, project automation hooks (post-create, pre-merge), and worktree path customization. (2) Automatic activity tracking that displays 🤖 (working) and 💬 (waiting) indicators in `wt list`, showing which branches have active Claude sessions. Use when setting up Worktrunk configuration, automating project workflows, or monitoring AI activity across branches.",
"version": "1.0.0",
"author": {
"name": "Worktrunk"