Skip to content
Back to search

worktrunk

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/max-sixty/worktrunk with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/max-sixty/worktrunk'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/max-sixty-worktrunk/badge.svg)](/listings/max-sixty-worktrunk)

HTML

<a href="/listings/max-sixty-worktrunk"><img src="/api/listings/max-sixty-worktrunk/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Homebrew (macOS & Linux):**

brew install worktrunk && wt config shell install

Shell integration allows commands to change directories.

**Cargo:**

cargo install worktrunk && wt config shell install

<details> <summary><strong>Windows & other</strong></summary>

**Windows.** `wt` defaults to Windows Terminal's command, so Winget additionally installs Worktrunk as `git-wt` to avoid the conflict:

winget install max-sixty.worktrunk
git-wt config shell install

Alternatively, disable Windows Terminal's alias (Settings → Apps → Advanced app settings → App execution aliases → "Terminal"/"Terminal Preview") to use `wt` directly.

> Free code signing provided by [SignPath.io](https://signpath.io/), certificate by [SignPath Foundation](https://signpath.org/) — [policy](https://worktrunk.dev/code-signing/).

**Arch Linux:**

sudo pacman -S worktrunk && wt config shell install

**Conda / Pixi** (community-maintained [feedstock](https://github.com/conda-forge/worktrunk-feedstock)):

conda install -c conda-forge worktrunk && wt config shell install

Or with [Pixi](https://pixi.sh): `pixi global install worktrunk && wt config shell install`.

</details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "worktrunk",
  3. "owner": {
  4. "name": "Worktrunk",
  5. "email": "m@maxroos.com"
  6. },
  7. "metadata": {
  8. "description": "Claude Code plugin for Worktrunk, a CLI for Git worktree management"
  9. },
  10. "plugins": [
  11. {
  12. "name": "worktrunk",
  13. "description": "Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows. This plugin provides configuration guidance (LLM commit messages, project hooks, worktree paths), automatic activity tracking (🤖/💬 indicators in `wt list` showing active Claude sessions), and a `/wt-diff` pane showing each worktree's changes.",
  14. "source": "./plugins/worktrunk"
  15. }
  16. ]
  17. }
README.md · README · 255 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <!-- markdownlint-disable MD033 -->
  2. <h1><img src="docs/public/logo.png" alt="Worktrunk logo" width="50" align="absmiddle">&nbsp;&nbsp;Worktrunk</h1>
  3. <!-- Crates.io badge below disabled while shields.io is rate-limited by crates.io
  4. (renders "CRATES.IO: INVALID"). Tracking: badges/shields#11879. Restore once fixed.
  5. [![Crates.io](https://img.shields.io/crates/v/worktrunk?style=for-the-badge&logo=rust)](https://crates.io/crates/worktrunk)
  6. -->
  7. [![Docs](https://img.shields.io/badge/docs-worktrunk.dev-blue?style=for-the-badge&logo=gitbook)](https://worktrunk.dev)
  8. [![License: MIT OR Apache-2.0](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue?style=for-the-badge)](https://opensource.org/licenses/MIT)
  9. [![CI](https://img.shields.io/github/actions/workflow/status/max-sixty/worktrunk/ci.yaml?event=push&branch=main&style=for-the-badge&logo=github)](https://github.com/max-sixty/worktrunk/actions?query=branch%3Amain+workflow%3Aci)
  10. [![Codecov](https://img.shields.io/codecov/c/github/max-sixty/worktrunk?style=for-the-badge&logo=codecov)](https://codecov.io/gh/max-sixty/worktrunk)
  11. [![Stars](https://img.shields.io/github/stars/max-sixty/worktrunk?style=for-the-badge&logo=github)](https://github.com/max-sixty/worktrunk/stargazers)
  12. [![maintained with tend](https://img.shields.io/badge/maintained_with-tend-bba580?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxNiAxNiI+PGcgdHJhbnNmb3JtPSJ0cmFuc2xhdGUoMCwxNikgc2NhbGUoMC4wMTI1LC0wLjAxMjUpIiBmaWxsPSIjZmZmIiBzdHJva2U9Im5vbmUiPjxwYXRoIGQ9Ik02ODAgMTEyOCBjNjIgLTk2IDY5IC0xNzggMjAgLTI0MSAtMTcgLTIyIC0yMCAtNDAgLTIwIC0xMzQgbDEgLTEwOCAyMSAyOCBjMTEgMTYgMzAgNDcgNDIgNzAgMTIgMjIgMzIgNDkgNDYgNTkgMzcgMjcgMTE0IDM4IDE4NCAyNyA5MyAtMTUgOTQgLTE4IDQ0IC03OSAtNzIgLTg4IC0xMDkgLTExMyAtMTc2IC0xMTcgLTMxIC0yIC02NCAxIC03MiA2IC0yMyAxNSAyMSA1NiAxMDcgOTggNDAgMjAgNzEgMzggNjkgNDAgLTYgNyAtODggLTE3IC0xMjYgLTM3IC00OSAtMjUgLTEwMCAtNzggLTEyMSAtMTI1IC0xNSAtMzMgLTE5IC02NiAtMTkgLTE4OCAwIC0xNTcgOCAtMTk1IDUwIC0yMzIgMTcgLTE2IDM2IC0yMCA4NSAtMTkgNjIgMSA2MyAxIDczIC0zMiA5IC0zMiA5IC0zMyAtMjIgLTQwIC01MCAtMTIgLTEzMiAtNyAtMTY0IDEwIC00MCAyMSAtNzkgNjkgLTkyIDExNCAtNSAyMCAtMTAgMTAyIC0xMCAxODIgMCA4MCAtNSAxNjIgLTExIDE4NCAtMjIgNzkgLTEzNSAxNjYgLTIzNCAxODEgLTM3IDYgLTM1IDMgMzAgLTI4IDc4IC0zOSAxNDQgLTkxIDEzMiAtMTA0IC01IC00IC0zNyAtOCAtNzEgLTggLTc3IDAgLTExNyAyNCAtMTgyIDEwOSAtNTIgNjggLTUxIDcwIDQyIDg1IDcxIDExIDE0MyAwIDE4MyAtMjkgMTYgLTExIDQwIC00MyA1NCAtNzMgMTMgLTI5IDMyIC01OSA0MSAtNjYgMTQgLTEyIDE2IC03IDE2IDU4IDAgNTkgNCA3NyAyMyAxMDIgMTkgMjYgMjMgNDYgMjUgMTMwIDMgNjcgMCA5OSAtNyA5OSAtNyAwIC0xMSAtMjMgLTEyIC01NyAwIC0zMiAtNiAtNzYgLTEyIC05NyBsLTEyIC00MCAtMjcgMzIgYy0zNCA0MSAtNDMgOTYgLTI0IDE1MSAxNCA0MSA3NSAxNDEgODYgMTQxIDMgMCAyMSAtMjQgNDAgLTUyeiIvPjwvZz48L3N2Zz4K)](https://github.com/max-sixty/tend)
  13. > **November 2026**: Worktrunk was [released](https://x.com/max_sixty/status/2006077845391724739?s=20) at the start of the year, and has quickly become the most popular git worktree manager. It's built with love (there's no slop!). Please let me know any frictions at all; I'm intensely focused on continuing to make Worktrunk excellent, and the biggest help is folks posting problems they perceive.
  14. Worktrunk is a CLI for git worktree management, designed for running AI agents in parallel.
  15. Worktrunk's three core commands make worktrees as easy as branches. Plus, Worktrunk has a bunch of quality-of-life features to simplify working with many parallel changes, including hooks to automate local workflows & copy-on-write build caches.
  16. A quick demo:
  17. ![Worktrunk Demo](https://cdn.jsdelivr.net/gh/max-sixty/worktrunk-assets@main/assets/docs/light/wt-core.gif)
  18. > ### 📚 Full documentation at [worktrunk.dev](https://worktrunk.dev) 📚
  19. <!-- ⚠️ AUTO-GENERATED from docs/src/content/docs/worktrunk.md#context-git-worktrees..worktrunk-makes-git-worktrees-as-easy-as-branches — edit source to update -->
  20. ## Context: git worktrees
  21. AI agents like Claude Code and Codex can handle longer tasks without
  22. supervision, such that it's possible to manage 5-10+ in parallel. Git's native
  23. worktree feature gives each agent its own working directory, so they don't step
  24. on each other's changes.
  25. But the git worktree UX is clunky. Even a task as small as starting a new
  26. worktree requires typing the branch name three times: `git worktree add -b feat
  27. ../repo.feat`, then `cd ../repo.feat`.
  28. ## Worktrunk makes git worktrees as easy as branches
  29. Worktrees are addressed by branch name; paths are computed from a configurable template. Commands that take a branch also accept the path of the worktree it is checked out in.
  30. <p class="workflow-stage">Start with the core commands</p>
  31. **Core commands:**
  32. <table class="cmd-compare">
  33. <thead>
  34. <tr>
  35. <th>Task</th>
  36. <th>Worktrunk</th>
  37. <th>Plain git</th>
  38. </tr>
  39. </thead>
  40. <tbody>
  41. <tr>
  42. <td>Switch worktrees</td>
  43. <td data-label="Worktrunk"><code>wt switch feat</code></td>
  44. <td data-label="Plain git"><code>cd ../repo.feat</code></td>
  45. </tr>
  46. <tr>
  47. <td>Create + start Claude</td>
  48. <td data-label="Worktrunk"><code>wt switch -c -x claude feat</code></td>
  49. <td data-label="Plain git"><pre><code>git worktree add -b feat ../repo.feat && \
  50. cd ../repo.feat && \
  51. claude</code></pre></td>
  52. </tr>
  53. <tr>
  54. <td>Clean up</td>
  55. <td data-label="Worktrunk"><code>wt remove</code></td>
  56. <td data-label="Plain git"><pre><code>cd ../repo && \
  57. git worktree remove ../repo.feat && \
  58. git branch -d feat</code></pre></td>
  59. </tr>
  60. <tr>
  61. <td>List with status</td>
  62. <td data-label="Worktrunk"><code>wt list</code></td>
  63. <td data-label="Plain git"><span class="cmd-compare-value"><code>git worktree list</code> (paths only)</span></td>
  64. </tr>
  65. </tbody>
  66. </table>
  67. <p class="workflow-stage">Expand into the more advanced commands as needed</p>
  68. <p class="workflow-heading"><strong>Workflow automation:</strong></p>
  69. - **[Hooks](https://worktrunk.dev/hook/)** — run commands on create, pre-merge, post-merge, etc
  70. - **[LLM commit messages](https://worktrunk.dev/llm-commits/)** — generate commit messages from diffs
  71. - **[Merge workflow](https://worktrunk.dev/merge/)** — squash, rebase, merge, clean up in one command
  72. - **[Interactive picker](https://worktrunk.dev/switch/#interactive-picker)** — browse worktrees with streaming CI status and diff, log, PR and comment previews
  73. - **[Share build caches](https://worktrunk.dev/step/#wt-step-copy-ignored)** — ten worktrees get `target/`, `node_modules/`, etc without building or copying them (on APFS, btrfs, and XFS)
  74. - **[`wt list --full`](https://worktrunk.dev/list/#full-mode)** — [CI status](https://worktrunk.dev/list/#ci-status) and [AI-generated summaries](https://worktrunk.dev/list/#llm-summaries) per branch
  75. - **[PR checkout](https://worktrunk.dev/switch/#pull-requests-and-merge-requests)** — `wt switch pr:123` to jump straight to a PR's branch
  76. - **[Dev server per worktree](https://worktrunk.dev/tips-patterns/#dev-server-per-worktree)** — `hash_port` template filter gives each worktree a unique port
  77. - **[Aliases](https://worktrunk.dev/extending/#aliases) & [per-branch variables](https://worktrunk.dev/config/#wt-config-state-vars)** — custom `wt <name>` commands and branch-scoped state for hook templates
  78. - ...and **[lots more](#next-steps)**
  79. Multiple parallel agents, same simple commands:
  80. ![Worktrunk omnibus demo: multiple Claude agents in Zellij tabs with hooks, LLM commits, and merge workflow](https://raw.githubusercontent.com/max-sixty/worktrunk-assets/main/assets/docs/light/wt-zellij-omnibus.gif)
  81. <!-- END AUTO-GENERATED -->
  82. <!-- ⚠️ AUTO-GENERATED from docs/src/content/docs/worktrunk.md#install..next-steps — edit source to update -->
  83. ## Install
  84. **Homebrew (macOS & Linux):**
  85. ```bash
  86. brew install worktrunk && wt config shell install
  87. ```
  88. Shell integration allows commands to change directories.
  89. **Cargo:**
  90. ```bash
  91. cargo install worktrunk && wt config shell install
  92. ```
  93. <details>
  94. <summary><strong>Windows & other</strong></summary>
  95. **Windows.** `wt` defaults to Windows Terminal's command, so Winget additionally installs Worktrunk as `git-wt` to avoid the conflict:
  96. ```bash
  97. winget install max-sixty.worktrunk
  98. git-wt config shell install
  99. ```
  100. Alternatively, disable Windows Terminal's alias (Settings → Apps → Advanced app settings → App execution aliases → "Terminal"/"Terminal Preview") to use `wt` directly.
  101. > Free code signing provided by [SignPath.io](https://signpath.io/), certificate by [SignPath Foundation](https://signpath.org/) — [policy](https://worktrunk.dev/code-signing/).
  102. **Arch Linux:**
  103. ```bash
  104. sudo pacman -S worktrunk && wt config shell install
  105. ```
  106. **Conda / Pixi** (community-maintained [feedstock](https://github.com/conda-forge/worktrunk-feedstock)):
  107. ```bash
  108. conda install -c conda-forge worktrunk && wt config shell install
  109. ```
  110. Or with [Pixi](https://pixi.sh): `pixi global install worktrunk && wt config shell install`.
  111. </details>
  112. ## Quick start
  113. Create a worktree for a new feature:
  114. ```console
  115. $ wt switch --create feature-auth
  116. ✓ Created branch feature-auth from main and worktree @ ~/repo.feature-auth
  117. ```
  118. This creates a new branch and worktree, then switches to it. Do your work, then check all worktrees with [`wt list`](https://worktrunk.dev/list/):
  119. ```console
  120. $ wt list
  121. Branch Status @± ^↕ ^…± Remote⇅ Commit Age Message
  122. @ feature-auth + ↑ +27 -8 ↑1 +31 4bc72dc 2h Add authenticatio…
  123. ^ main ^⇡ ⇡1 0e631ad 1d Initial commit
  124. ○ Showing 2 worktrees, 1 with changes, 1 ahead, hidden: Path
  125. ```
  126. The `@` marks the current worktree. `+` means staged changes, `↑1` means 1 commit ahead of main, `⇡` means unpushed commits.
  127. When done, either:
  128. **PR workflow** — commit, push, open a PR, merge via GitHub/GitLab, then clean up:
  129. ```bash
  130. wt step commit # commit staged changes
  131. gh pr create # or glab mr create
  132. wt remove # after PR is merged
  133. ```
  134. **Local merge** — squash, rebase onto main, fast-forward merge, clean up:
  135. ```console
  136. $ wt merge main
  137. ◎ Generating commit message and committing changes... (2 files, +53, no squashing needed)
  138. Add authentication module
  139. ✓ Committed changes @ a1b2c3d
  140. ◎ Merging 1 commit to main @ a1b2c3d (no rebase needed)
  141. * a1b2c3d Add authentication module
  142. auth.rs | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
  143. lib.rs | 2 ++
  144. 2 files changed, 53 insertions(+)
  145. ✓ Merged to main (1 commit, 2 files, +53)
  146. ◎ Removing feature-auth worktree & branch in background (same commit as main, _)
  147. ○ Switched to worktree for main @ ~/repo
  148. ```
  149. For parallel agents, create multiple worktrees and launch an agent in each:
  150. ```bash
  151. wt switch -x claude -c feature-a -- 'Add user authentication'
  152. wt switch -x claude -c feature-b -- 'Fix the pagination bug'
  153. wt switch -x claude -c feature-c -- 'Write tests for the API'
  154. ```
  155. The `-x` flag runs a command after switching; arguments after `--` are passed to it. Configure [post-start hooks](https://worktrunk.dev/hook/#hook-types) to automate setup (install deps, start dev servers).
  156. ## Next steps
  157. - Learn the core commands: [`wt switch`](https://worktrunk.dev/switch/), [`wt list`](https://worktrunk.dev/list/), [`wt merge`](https://worktrunk.dev/merge/), [`wt remove`](https://worktrunk.dev/remove/)
  158. - Set up [hooks](https://worktrunk.dev/hook/) for automated setup
  159. - Explore [LLM commit messages](https://worktrunk.dev/llm-commits/), [interactive
  160. picker](https://worktrunk.dev/switch/#interactive-picker), [Claude Code integration](https://worktrunk.dev/claude-code/), [CI
  161. status & PR links](https://worktrunk.dev/list/#ci-status)
  162. - Browse [tips & patterns](https://worktrunk.dev/tips-patterns/) for recipes: aliases, dev servers, databases, agent handoffs, and more
  163. - [Extending Worktrunk](https://worktrunk.dev/extending/) — customize workflows with hooks & aliases
  164. - Watch [@DevOpsToolbox's video on Worktrunk](https://youtu.be/WBQiqr6LevQ?t=345)
  165. - Run `wt --help` or `wt <command> --help` for quick CLI reference
  166. <!-- END AUTO-GENERATED -->
  167. ## Contributing
  168. - ⭐ Star the repo
  169. - Tell a friend about Worktrunk
  170. - [Open an issue](https://github.com/max-sixty/worktrunk/issues/new?title=&body=%23%23%20Description%0A%0A%3C!--%20Describe%20the%20bug%20or%20feature%20request%20--%3E%0A%0A%23%23%20Context%0A%0A%3C!--%20Any%20relevant%20context%3A%20your%20workflow%2C%20what%20you%20were%20trying%20to%20do%2C%20etc.%20--%3E) — feedback, feature requests, even a small friction or imperfect user message, or [a worktree pain not yet solved](https://github.com/max-sixty/worktrunk/issues/new?title=Worktree%20friction%3A%20&body=%23%23%20The%20friction%0A%0A%3C!--%20What%20worktree-related%20task%20is%20still%20painful%3F%20--%3E%0A%0A%23%23%20Current%20workaround%0A%0A%3C!--%20How%20do%20you%20handle%20this%20today%3F%20--%3E%0A%0A%23%23%20Ideal%20solution%0A%0A%3C!--%20What%20would%20make%20this%20easier%3F%20--%3E)
  171. - Share: [X](https://twitter.com/intent/tweet?text=Worktrunk%20%E2%80%94%20CLI%20for%20git%20worktree%20management&url=https%3A%2F%2Fworktrunk.dev) · [Reddit](https://www.reddit.com/submit?url=https%3A%2F%2Fworktrunk.dev&title=Worktrunk%20%E2%80%94%20CLI%20for%20git%20worktree%20management) · [LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fworktrunk.dev)
  172. > ### 📚 Full documentation at [worktrunk.dev](https://worktrunk.dev) 📚
  173. ### Star history
  174. <!-- `sealed_token` is a GitHub token of ours encrypted with star-history's public
  175. key, from "Generate embed code" on star-history.com. Without one the chart
  176. renders a "GitHub restricted access to star data" placeholder: GitHub limits
  177. stargazer data to a repo's admins and collaborators, and their servers are
  178. neither.
  179. The token is fine-grained and reaches only this repo. Its Contents permission
  180. has to be read *and write* — write access is what GitHub accepts as proof of
  181. collaborator status, so rotating to a read-only token brings the placeholder
  182. straight back. Publishing the ciphertext is safe on its own; what the scope
  183. buys is a bound on star-history, which decrypts it and so holds a credential
  184. that can push here until it expires 2027-08-16 — at which point the chart
  185. reverts to the placeholder with nothing else to signal it. star-history
  186. reports GitHub is working on restoring access, so drop this parameter once
  187. the plain URL renders a chart again. -->
  188. <a href="https://star-history.com/#max-sixty/worktrunk&Date">
  189. <img src="https://api.star-history.com/svg?repos=max-sixty/worktrunk&type=Date&sealed_token=2ySbQiVbkVrGmwgDsJya-xr4ApbVVvR0siYI46d22Xj_1kPCcgA9X0YpUGc3__aMuZ0ZAWzG4NBhJtqepYjlkoYrVwmKbgaPmGpNZTCfSyVp8EDA_IXaOOYW2whsOXDAi6g7HD9ezsnqSl58n7AqW2_4IQ4hY2p3h7tNv_3k4am5ASq1NdpbfrOUazCl" width="500" alt="Star History Chart">
  190. </a>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.