Skip to content

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

Rename advanced.md to claude-code.md and consolidate content

Maximilian Roos40da761d20ae
diff --git a/docs/content/advanced.md b/docs/content/claude-code.md
similarity index 66%
rename from docs/content/advanced.md
rename to docs/content/claude-code.md
index 17b6238d3..e76f9d535 100644
--- a/docs/content/advanced.md
+++ b/docs/content/claude-code.md
@@ -1,18 +1,14 @@
+++
-title = "Advanced Features"
+title = "Claude Code Integration"
weight = 23
[extra]
group = "Reference"
+++
-Most Worktrunk users get everything they need from `wt switch`, `wt list`, `wt merge`, and `wt remove`. The features below are optional power-user capabilities.
-
-## Claude Code integration
-
Worktrunk includes a Claude Code plugin for tracking agent status across worktrees.
-### Status tracking
+## Status tracking
The plugin adds status indicators to `wt list`:
@@ -34,7 +30,7 @@ The plugin adds status indicators to `wt list`:
- `πŸ€–` β€” Claude is working
- `πŸ’¬` β€” Claude is waiting for input
-### Install the plugin
+### Installation
```bash
$ claude plugin marketplace add max-sixty/worktrunk
@@ -51,19 +47,11 @@ $ wt config var set marker "βœ…" --branch feature # Specific branch
$ git config worktrunk.marker.feature "πŸ’¬" # Direct git config
```
-## Statusline integration
-
-`wt list statusline` outputs a single-line status for shell prompts, starship, or editor integrations.[^1]
+## Statusline
-[^1]: Currently this grabs CI status, so is too slow to use in synchronous contexts. If a faster version would be helpful, please [open an issue](https://github.com/max-sixty/worktrunk/issues).
+`wt list statusline --claude-code` outputs a single-line status for the Claude Code statusline (currently this grabs CI status, so is too slow to use in synchronous contextsβ€”if a faster version would be helpful, please [open an issue](https://github.com/max-sixty/worktrunk/issues)):
-### Claude Code statusline
-
-For Claude Code, outputs directory, branch status, and model:
-
-```
-~/w/myproject.feature-auth !πŸ€– Β±+42 -8 ↑3 ⇑1 ● | Opus
-```
+`~/w/myproject.feature-auth !πŸ€– @`<span style='color:#0a0'>+42</span> <span style='color:#a00'>-8</span>` `<span style='color:#0a0'>↑3</span>` `<span style='color:#0a0'>⇑1</span>` `<span style='color:#0a0'>●</span>` | Opus`
Add to `~/.claude/settings.json`:
@@ -75,11 +63,3 @@ Add to `~/.claude/settings.json`:
}
}
```
-
-## Interactive worktree picker
-
-`wt select` opens a fuzzy-search worktree picker with diff preview (Unix only).
-
-Type to filter, use arrow keys or `j`/`k` to navigate, Enter to switch. Preview tabs show working tree changes, commit history, or branch diff β€” toggle with `1`/`2`/`3`.
-
-See [wt select](@/select.md) for full keyboard shortcuts and details.
diff --git a/docs/content/quickstart.md b/docs/content/quickstart.md
index 2596638f6..8825cd2b5 100644
--- a/docs/content/quickstart.md
+++ b/docs/content/quickstart.md
@@ -84,4 +84,4 @@ Worktrunk checks if your changes are already on main before deleting the branch.
- Understand [why worktrees matter](@/concepts.md) and how Worktrunk improves on plain git
- Set up [project hooks](@/hooks.md) for automated setup
-- Explore advanced features: [LLM commit messages](@/llm-commits.md), [local merging](@/merge.md), [fzf-like picker](@/select.md), [Claude Code integration](@/advanced.md#claude-code-integration)
+- Explore advanced features: [LLM commit messages](@/llm-commits.md), [local merging](@/merge.md), [fzf-like picker](@/select.md), [Claude Code integration](@/claude-code.md)
diff --git a/docs/content/tips-patterns.md b/docs/content/tips-patterns.md
index 6b2314768..da9671b62 100644
--- a/docs/content/tips-patterns.md
+++ b/docs/content/tips-patterns.md
@@ -61,7 +61,7 @@ wt config var set marker "βœ…" --branch feature # Specific branch
git config worktrunk.marker.feature "πŸ’¬" # Direct git config
```
-See [Claude Code Integration](@/advanced.md#claude-code-integration) for plugin installation.
+See [Claude Code Integration](@/claude-code.md#installation) for plugin installation.
## Monitor CI across branches