worktrunk

max-sixty · max-sixty.worktrunk

A Git worktree manager for trunk-based development

worktrunk (wt) is a Git worktree manager designed for trunk-based development workflows. It simplifies creating, switching between, and managing Git worktrees, making it easy to work on multiple features or branches simultaneously without the overhead of stashing or switching branches in a single working directory.

winget install --id max-sixty.worktrunk --exact --source winget

Latest v0.36.0

Release Notes

Release Notes Improved

  • Git-style external subcommands: wt foo now runs wt-foo from PATH when foo is not a built-in, mirroring git foo → git-foo. Third-party tools can be installed and invoked as wt without touching this repo. Unrecognized commands show a git-style error with typo suggestions. Docs (#2054, thanks @pablospe for the suggestion in #2053)
  • {{ owner }} template variable: Expands to the GitHub/GitLab repository owner, useful for constructing URLs or paths in hook templates and worktree-path. (#2051, thanks @greggdonovan)
  • Typed env-var config overrides: WORKTRUNK__LIST__TIMEOUT_MS=30 and other typed overrides now work correctly. Previously, string-typed env values silently failed deserialization, wiping all user config and falling back to defaults. (#2062)
  • Config error attribution: Config load errors now identify the source — file errors show TOML line/column pointers, env-var errors list the offending WORKTRUNK_* variable. Previously all failures showed a generic message. (#2068)
  • Per-symbol atomic status rendering: The Status column in wt list and the wt switch picker now renders each symbol independently — unresolved gates show ⋯ at their position instead of fabricating defaults when the collect deadline expires. (#2067)
  • Hook error messages: Malformed hook command config now lists the three accepted forms (string, named table, pipeline list) with a pointer to wt hook --help, instead of an opaque serde error. (#2042)
  • Stale trash cleanup: wt remove now sweeps orphaned .git/wt/trash entries older than 24 hours after each removal, reclaiming space from interrupted background removals. (#2039) Changed
  • wt hook exits successfully when no hooks are configured: Previously errored; now prints a warning and exits 0, so scripts and CI can invoke wt hook unconditionally. (#2056)
  • Hook output log layout: Log files moved from flat .git/wt/logs/{name}.log to nested {branch}/{source}/{hook-type}/{name}.log. Per-branch listing/clearing is now O(that branch). logs get --format=json paths changed to relative. Legacy flat files are swept automatically. (#2041) Fixed
  • wt config show false "Not configured": When the shell init line lives in a sourced file (common with dotfile managers), config show no longer reports "Not configured" — it checks whether integration is actually active at runtime. Fixes #1306. (#2066, thanks @wouter-intveld for reporting)
  • Remove-then-switch hint: The hint for shadowed remote branches now uses --foreground so the chained wt remove && wt switch actually works (background removal left a placeholder directory blocking the switch). (#2040)
  • Conflict detection unified: The wt switch picker and wt list now both run both conflict probes (commit-level and working-tree). Previously the picker skipped the cheaper probe, leaving the fallback unreachable for clean worktrees; wt list non-full skipped the working-tree probe, missing conflicts from interrupted rebases. (#2064) Documentation
  • Surfaced vars & aliases on homepage and tips-patterns, cross-linked state keys to dedicated docs, tightened hook links. (#2035, #2036, #2037, #2038) Internal
  • Subcommand ordering aligned to documented policies (pipeline order for step, CRUD for state actions). (#2043, #2044) Install worktrunk 0.36.0 Install prebuilt binaries via shell script curl --proto '=https' --tlsv1.2 -LsSf https://github.com/max-sixty/worktrunk/releases/download/v0.36.0/worktrunk-installer.sh | sh && wt config shell install Install prebuilt binaries via powershell script powershell -ExecutionPolicy Bypass -c "irm https://github.com/max-sixty/worktrunk/releases/download/v0.36.0/worktrunk-installer.ps1 | iex"; git-wt config shell install Install prebuilt binaries via Homebrew brew install worktrunk && wt config shell install Download worktrunk 0.36.0 ────────────────────────────────────────────────┬───────────────────┬───────────── File │Platform │Checksum ────────────────────────────────────────────────┼───────────────────┼───────────── worktrunk-aarch64-apple-darwin.tar.xz │Apple Silicon macOS│checksum ────────────────────────────────────────────────┼───────────────────┼───────────── worktrunk-x86_64-apple-darwin.tar.xz │Intel macOS │checksum ────────────────────────────────────────────────┼───────────────────┼───────────── worktrunk-x86_64-pc-windows-msvc.zip │x64 Windows │checksum ────────────────────────────────────────────────┼───────────────────┼───────────── worktrunk-aarch64-unknown-linux-musl.tar.xz │ARM64 MUSL Linux │checksum ────────────────────────────────────────────────┼───────────────────┼───────────── worktrunk-x86_64-unknown-linux-musl.tar.xz │x64 MUSL Linux │checksum ────────────────────────────────────────────────┴───────────────────┴───────────── Install via Cargo cargo install worktrunk && wt config shell install Install via Winget (Windows) winget install max-sixty.worktrunk && git-wt config shell install Install via AUR (Arch Linux) paru worktrunk-bin && wt config shell install

Installer type: zip

Architecture Scope Download SHA256
x64 Download 5434D445A68FCF2D5771C6DC5AA137F13E4CBA1A6174C16A15029F4F51A9A9DF

Details

Homepage
https://github.com/max-sixty/worktrunk
License
MIT OR Apache-2.0
Publisher
max-sixty
Support
https://github.com/max-sixty/worktrunk/issues

Tags

cligitgit-worktreerustterminalworktree

Older versions (74)

v0.35.3
Architecture Scope Download SHA256
x64 Download 9C038BBC46F52F890FF9DC17103D622E84C6FFAB161E624702C95CD853892275
v0.35.2
Architecture Scope Download SHA256
x64 Download 3D2C66A25B87B6C72595FE67A20F76BEA117FB991855613280EC81DB0FD45A7B
v0.35.1
Architecture Scope Download SHA256
x64 Download 8D97AC5DCF1AD126DF648009A5BC437B6D9D58749A0736F000BFC6CB330238D7
v0.35.0
Architecture Scope Download SHA256
x64 Download 00F5A50B10BB59F38CEA96F0CC61DBA58AEAADC722E046049E0D66F1A22F559D
v0.34.2
Architecture Scope Download SHA256
x64 Download CBEFDB4F49088A95DCEC671B6879086F52D078414E91633C92EF8A8147916A30
v0.34.1
Architecture Scope Download SHA256
x64 Download 9B8E216552B4C9894FA36CF91A1F225EC01511D5264BE79A00F6BC9D594F3B4A
v0.34.0
Architecture Scope Download SHA256
x64 Download 9AD0C8740960EA25A290718961D9E942F24C2683FF35273A13C1B6EAA1B18A91
v0.33.0
Architecture Scope Download SHA256
x64 Download 1093577AE40CF256F7646B2DAA81FBEA5CCF0542F31F74FEEC06480CD9415485
v0.32.0
Architecture Scope Download SHA256
x64 Download C66C6E335B5458BE88A357C96FEC9B4EE2ACA596DC1DFF9E70C2BBE35403FEDA
v0.31.0
Architecture Scope Download SHA256
x64 Download 35F03FB8208ED68AA65231DDF1F726D76C37BDA8323DA61FB46468EC371F8EE4
v0.30.1
Architecture Scope Download SHA256
x64 Download 8667F2B8CCF7BA0457105C09AF0ACB6962B176E53F96096D88DC428DB5490953
v0.30.0
Architecture Scope Download SHA256
x64 Download 58166B2B0C104ADE5E026C9D447A786F125F763E8D49979EEE537193F7556F04
v0.29.4
Architecture Scope Download SHA256
x64 Download 10885B58E677054E9FF867FCF9EEFDD6C6DECD0C7032B25ECC52DC5FA7559294
v0.29.3
Architecture Scope Download SHA256
x64 Download 8EFFD9AE101FD934A45B8562B0FD0463E2E7E9A020971536A35E87A62DEF2E1B
v0.29.2
Architecture Scope Download SHA256
x64 Download 0F49622EDF1409B606D08F6CD1BBF1D4F139A0DB106C6D816720C438E327B62E
v0.29.1
Architecture Scope Download SHA256
x64 Download 779D247EDBADCD31B5C4EF1E53E832876186FED96D701004B83C225D9123BF67
v0.29.0
Architecture Scope Download SHA256
x64 Download 7761E312EE30543462606805F915083C3D2E855F6BF3F773062EB9112AB6213A
v0.28.2
Architecture Scope Download SHA256
x64 Download FE68654726548EA30560518EE8168893A2D7B792CBDFBB718148AD95766883C9
v0.28.1
Architecture Scope Download SHA256
x64 Download 3320A7A3FF485C37541636BC4149F2C1123B7361C1320C355E6B8D2B769D3474
v0.28.0
Architecture Scope Download SHA256
x64 Download 8CB44BCF30B7B113A12382BD3002868657E29CA9DDF5F432BB84D28A82E0FA5F
v0.27.0
Architecture Scope Download SHA256
x64 Download FCB8345FA85C6C12B4E1BF327AF832BA8460D65F177D684FF1C39A1AA95F0B81
v0.26.1
Architecture Scope Download SHA256
x64 Download D393EFD1D965D3D13BFF52F5081D0C97A74AFB1CA3C8EF47E4D1C879F8E6B711
v0.26.0
Architecture Scope Download SHA256
x64 Download 76A39C52B51A0055CB723784E3BFF1432E20F6533A3A7886196E7B63F846031A
v0.25.0
Architecture Scope Download SHA256
x64 Download 038146BEE263A49B3CC15BE65C96FC400B8C465A85899421B5E3C0E634014BC8
v0.24.1
Architecture Scope Download SHA256
x64 Download DBAA1435AF9CCD7B3D302F534F6983DC7854AF66703B3E2C7735A7B24D0B32CF
v0.24.0
Architecture Scope Download SHA256
x64 Download 460515A71EE617789FB95ABB7083BDA79FE8BD99CB144DCD25CED36153EBA6CC
v0.23.3
Architecture Scope Download SHA256
x64 Download 40CF9944D0A27E802FEF2AD0F90BC48256AE54CFB936174109589D9838F3F3F8
v0.23.2
Architecture Scope Download SHA256
x64 Download DB9A732337BD855BF567450CC38B312A3428E19FFFB2283E7FB7E9793437E3A5
v0.23.1
Architecture Scope Download SHA256
x64 Download E9577875C4E96196BA105D927F0A1312FDB59095E07824ED7F1F813C4F6E4458
v0.23.0
Architecture Scope Download SHA256
x64 Download 98BFD7F9BEEC23C7F4D7E044A65869B65E202260402D55A3D0847EB46D920606
v0.22.0
Architecture Scope Download SHA256
x64 Download B9A7F5C027BF9B9AC0B21A31E4D6BDEBE3B3C193170CA6A5FAA6AA91F1C791E6
v0.21.0
Architecture Scope Download SHA256
x64 Download 6D2BA343879CAA4D196A657C9AE53691E1D2740B5B6E62A0E08058955A50578D
v0.20.3
Architecture Scope Download SHA256
x64 Download CCA65CEDB3F7F2E8B33BD4B65A200336C3B4679415872697007C118A0A26C4E0
v0.20.2
Architecture Scope Download SHA256
x64 Download 3ABB4C5A6A30B6A3E78F5D79E99ED811D06C911AAB24EC529F08490A1FE27C18
v0.20.1
Architecture Scope Download SHA256
x64 Download EDD48775E18B5087138AF987DAA667C2482142D585490176ACEA396BB45B5CCF
v0.20.0
Architecture Scope Download SHA256
x64 Download B7988FDF636540D25061CA8CE74D1D6EE3BAACE57AE21077E9180CA9E0C7459F
v0.19.0
Architecture Scope Download SHA256
x64 Download 888247185DFB38448275EB072421BC0F2F4828184994BEFAAB2A24AB2A838308
v0.18.2
Architecture Scope Download SHA256
x64 Download 0CA0D0133A55DD584F7A309C3425BAF6DC748EB5373AAA9CE5133AC8175C1142
v0.18.1
Architecture Scope Download SHA256
x64 Download 37803531F6028E25617B5FBF31E4CEB25D795B27A258E1D79D8FE72EDA5DDFCF
v0.18.0
Architecture Scope Download SHA256
x64 Download 59CD8BBB93E470B7FF3846BAB74C8C901687685FF1F2D32D084D3419FA8C0BC7
v0.17.0
Architecture Scope Download SHA256
x64 Download 1D4CE38DE691AB75530CCA87AF1316D20EDC3A0086E4E01FC4512A9401B4674D
v0.16.0
Architecture Scope Download SHA256
x64 Download 89648F3C50E754F1222E36C852A8CA31C38B19930701BA8599469D91BEBCF059
v0.15.5
Architecture Scope Download SHA256
x64 Download 460BE4BB222E1AC0A0BA41D8F5A337E39697666CE3FA0EC716A0F0385ABB4068
v0.15.4
Architecture Scope Download SHA256
x64 Download 3034B6C0958A0F9F58C90C13B4AF68B0FD9AF312BC20C4E412DDACEFD08EB4CD
v0.15.3
Architecture Scope Download SHA256
x64 Download A427DB19FDA4811FFED96E91EC8101F566AE82BC58156326E54F935BC00D7D71
v0.15.2
Architecture Scope Download SHA256
x64 Download 688DCBB16EAF2683470505EBCEBDD72E9906CC257EF822C198BEC680F187F635
v0.15.1
Architecture Scope Download SHA256
x64 Download AA29555A8D18FAAEAA8041CBE2D251D43DF14BD6005C2C323AE6A5BB7EF59872
v0.15.0
Architecture Scope Download SHA256
x64 Download 4765CB5833406DF80821D6D0F2DACA4746A52603EF750ECB94711016E1D2E732
v0.14.2
Architecture Scope Download SHA256
x64 Download 68BAC63D9716F2846379EE88E3AB8AAA02AE2BF20572230B25E34839F9CD4857
v0.14.1
Architecture Scope Download SHA256
x64 Download 27D21CB998150BC49EB0BDCA5C39C055AB1CC8700050493CED26A484871378B2
v0.14.0
Architecture Scope Download SHA256
x64 Download 876B574422D306C8BBF91594B10C03C42BC9BAA64242BC4BC3D1B9EC73B6F1A3
v0.13.4
Architecture Scope Download SHA256
x64 Download 7ADBD17F794E506572B8D5497F5216C0772C058649A2E370C88145BB434A341E
v0.13.2
Architecture Scope Download SHA256
x64 Download 6D6703C513D0D9980450AC4F5BC26C235C1808E51AC89E72412C9728015D8CBE
v0.13.1
Architecture Scope Download SHA256
x64 Download AB83AEED65F24BA76494B3C1ED099F6F3F2B772CD7BCC5B86CF7AFD7E05E6BBE
v0.13.0
Architecture Scope Download SHA256
x64 Download 1C0B097D25323BC216E2457ED121F2576831F2367DD267814B6DD8FF96B87573
v0.12.0
Architecture Scope Download SHA256
x64 Download 73F5DABE030D30C44E6B1CCFAF89BA8750399E3D997B428A54F1015824744348
v0.11.0
Architecture Scope Download SHA256
x64 Download B1E9B676AFBE602C6A5DA8BB7D56C95B64ACA90B626F86041E2328C955D6FB0A
v0.10.0
Architecture Scope Download SHA256
x64 Download 8CBCFC131C4CAC5D7004D0B41064D67444C035A46C8D41577FF0BACA4C6FA540
v0.9.5
Architecture Scope Download SHA256
x64 Download B2C5911A56B43A5E96F90249AAE0F37EEF37F429A379C267F7B9AF24A105C11A
v0.9.4
Architecture Scope Download SHA256
x64 Download 6B9F56DE80236432A31255E621993257D9D2F1E86B03472377C19FF758F17F49
v0.9.3
Architecture Scope Download SHA256
x64 Download B6B740D22C91FCC52215898C7101B42EE0BC948C9C7C007AFDBFFCDC20487BB0
v0.9.2
Architecture Scope Download SHA256
x64 Download 8D4C2ED16D6410CA55BD1317BBFEE9EA486BB3A142C8DB52AF9B427BB94657C3
v0.9.1
Architecture Scope Download SHA256
x64 Download DB7160F54177BD3A25007E4CB104A79D60F45809A384D5C16220FD3B58C5FDE1
v0.9.0
Architecture Scope Download SHA256
x64 Download 1F3FC58A3E4706C395E7918614D7F788D5CF1233285F9C5B9029AEA1EA009403
v0.8.5
Architecture Scope Download SHA256
x64 Download 712A402D3C6E719F62AED67E630754C3B45CCC01C34A66FD9FEF70D5EF104F22
v0.8.4
Architecture Scope Download SHA256
x64 Download 81274C119FAF5B15FB6349EBD4F2DDB4DD4A9AE7993B9D7FE91B5FADDF34CCAE
v0.8.3
Architecture Scope Download SHA256
x64 Download AC39CB749D58770EAAD7C9F74CFA7721C44956124E832CB2BB776ED64F0B2FBF
v0.8.1
Architecture Scope Download SHA256
x64 Download 83413D5A2DFC6DCD304DB5ED53AAB4FB2AAE387570754A39B5055F39C6A0E64D
v0.7.0
Architecture Scope Download SHA256
x64 Download 80A111959A87A60A388E027DDF5B27198F093FF5CDFCBE08FDD261A0C0EC5DD1
v0.6.1
Architecture Scope Download SHA256
x64 Download 0161E6B7EEDDE8B2F028D6D70C0B29E744CDDA26716E89EAEDC5A1858BAC241E
v0.6.0
Architecture Scope Download SHA256
x64 Download 999B7D3CE6D0609394135B916B36285A3C7A13232CF0834E1EFFF3063182E703
v0.5.2
Architecture Scope Download SHA256
x64 Download 373A4CADCF4C3E03AD67BDB8CC95C83B8579681A9960B098205CA67A6867A8A8
v0.5.1
Architecture Scope Download SHA256
x64 Download 101F4B5C663D13810889C8A042B11583EAEA5075B92BC8F7BB19864AA087AF38
0.5.0
Architecture Scope Download SHA256
x64 Download 3188C8464234EC4BE89D773353170479C55708BBEF8BB977184DD7B8B5EC0609