Skip to content

Restore squad-cli as a default-installed tool (reverse part of #475) #487

@primetimetank21

Description

@primetimetank21

Restore squad-cli as a default-installed tool (reverse part of #475)

Decision (Earl, 2026-06-19): squad-cli should be installed by default as part of dev-setup. It is a developer tool (the engine behind the gosquad launcher alias, gosquad='copilot --agent squad --yolo'), NOT squad coordination infrastructure. PR #475 (de-squad) removed its installer along with the embedded squad -- the same over-scrub class as the earlier gosquad removal that had to be reverted. This issue restores it.

Background

PR #475 (baee5d9; squad-cli removal in commit a3f257a) deleted the squad-cli installer and all call sites. The original files are recoverable from git at a3f257a^:

  • scripts/linux/tools/squad-cli.sh
  • scripts/windows/tools/squad-cli.ps1

Scope (whatever the final design)

  • Restore scripts/linux/tools/squad-cli.sh and scripts/windows/tools/squad-cli.ps1 (recover from a3f257a^, modernize to current tool/script conventions).
  • Re-add to the default install sequence in scripts/linux/setup.sh (run_tool) and scripts/windows/setup.ps1 (dot-source + Install-SquadCli), positioned after node/npm -- dependency chain is nvm -> node -> npm -> squad-cli (squad-cli installs via npm).
  • Re-add the .tool-versions pin if that pattern is still used (verify -- chore: remove embedded squad (infra + config) #475 removed it).
  • Re-add the README tools-table row + repo-structure-diagram entry.
  • Restore/adapt tests: tests/test_nvm_bootstrap.sh (squad-cli cases) + tests/test_windows_setup.ps1 (Windows cases) + any e2e-install.yml install check -- following current test conventions, not blindly reverting deleted blocks.
  • Verify ASCII-clean (PS 5.1), alias parity unaffected, idempotency (managed-block pattern) preserved.

Constraints

  • Dependency ordering is positional in setup -- squad-cli MUST come after the node/npm chain.
  • develop is PR-protected; land via PR + admin-merge.
  • Confirm the exact install method (npm install -g @bradygaster/squad-cli vs other) against the recovered installer + current upstream package name.

Relationship to #468

#468 (customizable install, flags-first) keeps squad-cli in its tool registry. This restore makes squad-cli a real installable tool; once #468 lands, it becomes one of the selectable/default tools. Restore can proceed independently of / in parallel with #468.

Out of scope

  • Does NOT re-introduce the embedded .squad/ coordination tree, squad workflows, squad.agent.md, or spawn scripts -- those stay removed (HQ coordinates the squad externally). This is ONLY the squad-cli tool installer.

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions