wtw
0.2.11
Git worktree + VS Code/(vscode based editors like Cursor) workspace manager. Creates, switches, and removes worktrees with auto-generated workspace files, unique Peacock colors, shell aliases, and fuzzy name resolution.
Minimum PowerShell version
7.0
Installation Options
Owners
Copyright
(c) 2025-present Sergey Novikov. All rights reserved.
Package Details
Author(s)
- Sergey Novikov
Tags
git worktree vscode cursor workspace peacock devtools ssh remote
Functions
Add-WtwEntry Copy-WtwWorkspace Enter-WtwWorktree Get-WtwList Get-WtwUpdateStatus Get-WtwWindowTitle Initialize-WtwConfig Install-Wtw Install-WtwSkill Invoke-Wtw Invoke-WtwClean Invoke-WtwHost New-WtwWorkspace New-WtwWorktree Open-WtwWorkspace Register-WtwProfile Register-WtwTerminalTitle Remove-WtwWorktree Set-WtwColor Sync-WtwWorkspace Unregister-WtwEntry Update-Wtw
Dependencies
This module has no dependencies.
Release Notes
`wtw update` replaces the installed copy at ~/.wtw/module with the latest PowerShell Gallery release, and is now a separate command from `wtw install`, which installs the checkout you run it from. The two used to be aliases, so `wtw update` from a normal shell hit the self-install guard and refused to do anything. Which command wtw offers depends on how the running copy was installed: `wtw install` records that in ~/.wtw/module/INSTALLATION.json, and the once-per-session update notice reads it, so a hand-installed copy is no longer told to run `Update-Module wtw` — a command that either errors or updates a copy no loader imports, since the profile snippet, the zsh and bash wrappers and the Windows cmd shim all name ~/.wtw/module/wtw.psm1 by path. A leftover `Install-Module wtw` on PSModulePath is reported and can be removed, because a bare `Import-Module wtw` resolves to that one instead. A local build newer than the published release, or the same version, is reported as current rather than as a problem. `--at` is accepted as an alias of `--on`. Fixes `wtw create` reporting "Index was outside the bounds of the array" while registering a worktree with ChatGPT Desktop: the lookup for an existing project indexed an empty result, which throws under the module's StrictMode, and a worktree Codex has never seen is exactly when that result is empty. Workspace colours now cover every key the Peacock extension also writes, including the command centre, status bar and horizontal activity bar, so nothing is left for it to fill in; wtw records the colour as `wtw.color` rather than `peacock.color`, which is what stopped Peacock re-applying its own palette — in Cursor it forces the title bar and command centre foreground to #595959 whatever the background is. Generated window titles drop the literal spaces around ${separator} so an editor-less window reads "name — Cursor" instead of "name — — Cursor", and the selected file shows once one is open.
FileList
- wtw.nuspec
- LICENSE
- README.md
- completions\wtw.auto-completion.ps1
- private\Add-HexAlpha.ps1
- private\Connect-WtwRemoteWorktree.ps1
- private\Convert-HslToHex.ps1
- private\Convert-WtwArgsToSplat.ps1
- private\ConvertTo-DarkerHexColor.ps1
- private\ConvertTo-HexComponent.ps1
- private\ConvertTo-PeacockColorBlock.ps1
- private\ConvertTo-WtwBranchSafeName.ps1
- private\ConvertTo-WtwRemoteUri.ps1
- private\ConvertTo-WtwRgbArray.ps1
- private\ConvertTo-WtwWorkspaceFileStem.ps1
- private\Find-WtwContrastColor.ps1
- private\Format-WtwTable.ps1
- private\Get-ContrastForeground.ps1
- private\Get-PerceptualDistance.ps1
- private\Get-WtwAllTargetNames.ps1
- private\Get-WtwCmuxTabLabel.ps1
- private\Get-WtwColorAssignment.ps1
- private\Get-WtwColorCircleEmoji.ps1
- private\Get-WtwConfig.ps1
- private\Get-WtwCurrentPrNumber.ps1
- private\Get-WtwEditDistance.ps1
- private\Get-WtwEditorFamily.ps1
- private\Get-WtwGitCommand.ps1
- private\Get-WtwInstallInfo.ps1
- private\Get-WtwListFormatHelpers.ps1
- private\Get-WtwNetworkPeers.ps1
- private\Get-WtwPropertyNames.ps1
- private\Get-WtwRegistry.ps1
- private\Get-WtwRemoteTarget.ps1
- private\Get-WtwRepoAliases.ps1
- private\Get-WtwRepoFromCwd.ps1
- private\Get-WtwSessionScript.ps1
- private\Get-WtwSourceGitBookmark.ps1
- private\Get-WtwTerminal.ps1
- private\Get-WtwWindowTitleHelpers.ps1
- private\Initialize-WtwCmuxCurrentSession.ps1
- private\Initialize-WtwWorktreeMetadata.ps1
- private\Install-WtwGalleryPackage.ps1
- private\Install-WtwItermPromptHook.ps1
- private\Invoke-WtwAgentCtl.ps1
- private\Invoke-WtwClaudeProject.ps1
- private\Invoke-WtwCmuxProject.ps1
- private\Invoke-WtwCmuxRawCommand.ps1
- private\Invoke-WtwCodexProject.ps1
- private\Invoke-WtwCursorProject.ps1
- private\Invoke-WtwEditorCli.ps1
- private\Invoke-WtwSourceGit.ps1
- private\Invoke-WtwSupersetWorkspace.ps1
- private\Invoke-WtwT3Project.ps1
- private\Invoke-WtwWmuxProject.ps1
- private\Lighten-HexColor.ps1
- private\New-WtwColor.ps1
- private\New-WtwDefaultConfig.ps1
- private\New-WtwWorkspaceFile.ps1
- private\Open-WtwRemoteWorkspace.ps1
- private\Read-JsoncFile.ps1
- private\Repair-WtwSupersetProjectPath.ps1
- private\Reset-WtwTerminalColor.ps1
- private\Resolve-WtwColorArgs.ps1
- private\Resolve-WtwColorInput.ps1
- private\Resolve-WtwCurrentTarget.ps1
- private\Resolve-WtwDefaultTemplatePath.ps1
- private\Resolve-WtwEditorCommand.ps1
- private\Resolve-WtwEditorPreference.ps1
- private\Resolve-WtwFuzzyMatch.ps1
- private\Resolve-WtwHost.ps1
- private\Resolve-WtwRealPath.ps1
- private\Resolve-WtwRepo.ps1
- private\Resolve-WtwRepoRoot.ps1
- private\Resolve-WtwRepoTemplatePath.ps1
- private\Resolve-WtwSessionScript.ps1
- private\Resolve-WtwTarget.ps1
- private\Resolve-WtwTerminalWorkspaceMetadata.ps1
- private\Restore-WtwInstalledModule.ps1
- private\Save-WtwConfig.ps1
- private\Save-WtwRegistry.ps1
- private\Set-WtwAgentCtlProfile.ps1
- private\Set-WtwTerminalColor.ps1
- private\Set-WtwWorktreeEnv.ps1
- private\Show-WtwCommandHelp.ps1
- private\Split-WtwOnHostArgs.ps1
- private\Sync-WtwSshConfig.ps1
- private\Test-WtwAliasMatch.ps1
- private\Test-WtwEditorCli.ps1
- private\Test-WtwRemoteExtension.ps1
- private\Write-WtwColorSwatch.ps1
- private\Write-WtwInstallRecord.ps1
- private\Write-WtwUpdateNotice.ps1
- public\Add-WtwEntry.ps1
- public\Copy-WtwWorkspace.ps1
- public\Enter-WtwWorktree.ps1
- public\Get-WtwList.ps1
- public\Get-WtwUpdateStatus.ps1
- public\Get-WtwWindowTitle.ps1
- public\Initialize-WtwConfig.ps1
- public\Install-Wtw.ps1
- public\Install-WtwSkill.ps1
- public\Invoke-Wtw.ps1
- public\Invoke-WtwAgent.ps1
- public\Invoke-WtwClean.ps1
- public\Invoke-WtwHost.ps1
- public\Invoke-WtwSbx.ps1
- public\New-WtwWorkspace.ps1
- public\New-WtwWorktree.ps1
- public\Open-WtwClaudeCodeWorkspace.ps1
- public\Open-WtwCmuxWorkspace.ps1
- public\Open-WtwSupersetWorkspace.ps1
- public\Open-WtwT3Workspace.ps1
- public\Open-WtwWmuxWorkspace.ps1
- public\Open-WtwWorkspace.ps1
- public\Register-WtwProfile.ps1
- public\Register-WtwTerminalTitle.ps1
- public\Remove-WtwWorktree.ps1
- public\Set-WtwColor.ps1
- public\Sync-WtwWorkspace.ps1
- public\Unregister-WtwEntry.ps1
- public\Update-Wtw.ps1
- shell\wtw.bash
- shell\wtw.cmd
- shell\wtw.zsh
- wtw.psd1
- wtw.psm1
Version History
| Version | Downloads | Last updated |
|---|---|---|
| 0.2.14 | 9 | 8/23/2026 |
| 0.2.11 (current version) | 10 | 8/21/2026 |
| 0.2.10 | 5 | 8/21/2026 |
| 0.2.9 | 9 | 8/15/2026 |
| 0.2.3 | 4 | 8/15/2026 |
| 0.2.0 | 4 | 8/14/2026 |
| 0.1.48 | 5 | 8/13/2026 |
| 0.1.46 | 11 | 8/2/2026 |
| 0.1.45 | 12 | 7/29/2026 |
| 0.1.43 | 10 | 7/28/2026 |
| 0.1.40 | 8 | 7/26/2026 |
| 0.1.39 | 8 | 7/25/2026 |
| 0.1.37 | 9 | 7/24/2026 |
| 0.1.35 | 14 | 7/24/2026 |
| 0.1.33 | 11 | 7/24/2026 |
| 0.1.31 | 19 | 7/6/2026 |
| 0.1.30 | 6 | 7/6/2026 |
| 0.1.29 | 19 | 6/2/2026 |
| 0.1.25 | 5 | 5/30/2026 |
| 0.1.24 | 4 | 5/30/2026 |
| 0.1.23 | 8 | 5/28/2026 |
| 0.1.22 | 8 | 5/28/2026 |
| 0.1.21 | 7 | 5/28/2026 |
| 0.1.20 | 6 | 5/26/2026 |
| 0.1.19 | 7 | 5/26/2026 |
| 0.1.18 | 6 | 5/26/2026 |
| 0.1.17 | 6 | 5/23/2026 |
| 0.1.16 | 6 | 5/23/2026 |
| 0.1.15 | 22 | 5/19/2026 |
| 0.1.14 | 6 | 5/18/2026 |
| 0.1.13 | 6 | 5/16/2026 |
| 0.1.10 | 6 | 5/16/2026 |
| 0.1.9 | 6 | 5/14/2026 |
| 0.1.6 | 6 | 5/11/2026 |
| 0.1.5 | 6 | 5/7/2026 |
| 0.1.4 | 9 | 4/23/2026 |
| 0.1.2 | 4 | 4/20/2026 |
| 0.1.1 | 6 | 4/12/2026 |
| 0.1.0 | 5 | 4/12/2026 |