Summary
The published claude-squad_1.0.17_windows_amd64.zip binary builds and launches, but creating any new session fails instantly with:
failed to start new session: error starting tmux session: unsupported
The TUI itself renders, cs version works, the menu navigates — but the core feature (spawning an agent under a tmux session) is unreachable on native Windows.
Root cause
session/tmux/pty.go calls pty.Start(cmd) from github.com/creack/pty. On any non-Unix GOOS, creack/pty falls back to pty_unsupported.go, whose open() returns ErrUnsupported. The Go cross-build for windows/amd64 succeeds because the stub compiles cleanly, so GoReleaser ships a binary that has no functional PTY path.
Reference: https://github.com/creack/pty/blob/master/pty_unsupported.go
Reproduction
- Windows 11 native (no WSL).
- Download
claude-squad_1.0.17_windows_amd64.zip from the v1.0.17 release.
- Extract
claude-squad.exe, run from a git repo in PowerShell or Git Bash.
- Press
n to create a new session.
- Error appears immediately, no tmux command is ever executed.
Environment
- OS: Windows 11 Pro 26220
- claude-squad: v1.0.17 (official Windows release)
- Shell tested: PowerShell 7, Git Bash 2.x
- tmux:
marlocarlo.psmux 3.3.1 (a PowerShell-based tmux-compatible multiplexer, since real tmux has no native Windows port). Note: psmux is not invoked at all in this bug — the failure happens inside pty.Start() before any tmux command runs.
- Verified the failure is upstream of tmux by reading
session/tmux/pty.go and the linked creack/pty stub.
Suggested fix
Replace github.com/creack/pty with a cross-platform PTY library that supports Windows ConPTY. Candidates:
Happy to contribute a PR if a maintainer can confirm the preferred direction (especially around the *os.File return type, which doesn't map cleanly onto a Windows HANDLE — the abstraction in Pty.Start() may need to widen to an io.ReadWriteCloser).
Workarounds for other Windows users finding this
Currently none. The Windows binary ships but is non-functional for the tool's primary purpose. The README does not mention Windows support status.
Summary
The published
claude-squad_1.0.17_windows_amd64.zipbinary builds and launches, but creating any new session fails instantly with:The TUI itself renders,
cs versionworks, the menu navigates — but the core feature (spawning an agent under a tmux session) is unreachable on native Windows.Root cause
session/tmux/pty.gocallspty.Start(cmd)fromgithub.qkg1.top/creack/pty. On any non-Unix GOOS, creack/pty falls back topty_unsupported.go, whoseopen()returnsErrUnsupported. The Go cross-build forwindows/amd64succeeds because the stub compiles cleanly, so GoReleaser ships a binary that has no functional PTY path.Reference: https://github.com/creack/pty/blob/master/pty_unsupported.go
Reproduction
claude-squad_1.0.17_windows_amd64.zipfrom the v1.0.17 release.claude-squad.exe, run from a git repo in PowerShell or Git Bash.nto create a new session.Environment
marlocarlo.psmux3.3.1 (a PowerShell-based tmux-compatible multiplexer, since real tmux has no native Windows port). Note: psmux is not invoked at all in this bug — the failure happens insidepty.Start()before any tmux command runs.session/tmux/pty.goand the linked creack/pty stub.Suggested fix
Replace
github.com/creack/ptywith a cross-platform PTY library that supports Windows ConPTY. Candidates:github.com/aymanbagabas/go-pty— by Charm (same org as bubbletea, which claude-squad already depends on). Designed as a creack/pty drop-in with ConPTY support.github.com/UserExistsError/conpty— pure Go ConPTY wrapper, lower-level.Happy to contribute a PR if a maintainer can confirm the preferred direction (especially around the
*os.Filereturn type, which doesn't map cleanly onto a Windows HANDLE — the abstraction inPty.Start()may need to widen to anio.ReadWriteCloser).Workarounds for other Windows users finding this
Currently none. The Windows binary ships but is non-functional for the tool's primary purpose. The README does not mention Windows support status.