Skip to content

fix: document SSH agent requirement and workaround#31

Merged
bradygaster merged 25 commits intodevfrom
squad/30-ssh-agent-hang-fix
Feb 13, 2026
Merged

fix: document SSH agent requirement and workaround#31
bradygaster merged 25 commits intodevfrom
squad/30-ssh-agent-hang-fix

Conversation

@bradygaster
Copy link
Copy Markdown
Owner

Closes #30

What

Documents the SSH agent / npm spinner interaction that causes npx github:bradygaster/squad to appear hung when no SSH agent is running.

Changes

  • README.md: Added SSH note to Install section + Known Limitations bullet
  • docs/scenarios/troubleshooting.md: New troubleshooting guide covering SSH hang, gh auth, Node version, and other common issues

Root Cause

npm resolves github: specifiers via git+ssh://. When no SSH agent is available, git prompts for a passphrase — but npm's progress spinner overwrites the prompt. This is an npm TTY handling issue, not a Squad bug.

Credit

Excellent bug report by @dnoriegagoodwin in #30 — clear root cause analysis, reproduction steps, and workarounds.

bradygaster and others added 25 commits February 11, 2026 13:50
Co-authored-by: bradygaster <41929050+bradygaster@users.noreply.github.com>
Co-authored-by: bradygaster <41929050+bradygaster@users.noreply.github.com>
Co-authored-by: bradygaster <41929050+bradygaster@users.noreply.github.com>
Co-authored-by: bradygaster <41929050+bradygaster@users.noreply.github.com>
Session: 2026-02-12-v040-sprint
Requested by: Brady

Changes:
- Logged v0.4.0 sprint session (5 parallel issues, 118 tests green)
- Merged 8 decision(s) from inbox into decisions.md (branching strategy, release hardening, version display, tips & tricks, cross-client research)
- Added deduplication notes for overlapping branching and release decisions
- Propagated team updates to affected agent history files (keaton, kobayashi, kujan, mcmanus)
Session: 2026-02-12-issue6-gonogo
Requested by: Brady

Changes:
- logged session to .ai-team/log/2026-02-12-issue6-gonogo.md
- merged 2 decisions from inbox into decisions.md
- deleted processed inbox files
- propagated updates to Fenster, Keaton, Verbal, McManus history files
…-agent-label

Display Squad version in agent name across Copilot hosts
Session: 2026-02-12-notification-architecture
Requested by: Brady

Changes:
- Logged session to .ai-team/log/2026-02-12-notification-architecture.md
- No decision inbox files to merge
- No deduplication needed in decisions.md
Session: 2026-02-12-notification-architecture
Requested by: Brady

Changes:
- Logged session to .ai-team/log/2026-02-12-notification-architecture.md
- Merged 2 decision files from inbox into decisions.md
- Deleted merged inbox files
- Propagated updates to keaton and mcmanus agent history files
When Ralph clears the board, instead of fully stopping he now enters
idle-watch mode: automatically re-checking for new work every N minutes
(default: 10). The polling interval is configurable via natural language
(e.g., 'Ralph, check every 30 minutes').

- Add idle-watch polling behavior to Ralph's state machine
- Add 'Ralph, check every N minutes' trigger command
- Update Ralph state: active/idle/watching + poll_interval
- Distinguish idle-watch (automatic on board clear) from full idle
  (explicit 'Ralph, idle' / 'stop')
- Update docs/features/ralph.md with idle-watch documentation
feat: Ralph idle-watch mode — auto-poll for new work after board clears
# Conflicts:
#	docs/guide.md
#	test/index.test.js
- New squad-label-enforce.yml: mutual exclusivity for go:* and release:*
  labels. Auto-removes conflicting labels in same namespace, posts update
  comments, auto-applies release:backlog on go:yes, strips release on go:no
- Updated sync-squad-labels.yml: syncs 8 static go:/release: labels
  alongside dynamic squad:{member} labels
- Updated squad-triage.yml: auto-applies go:needs-research as default
  triage verdict on new squad issues
- Updated squad-heartbeat.yml: Ralph detects missing go: verdicts and
  go:yes issues without release: targets
Session: 2026-02-13-go-release-labels
Requested by: Brady

Changes:
- Logged session to .ai-team/log/
- No decisions merged from inbox (inbox was empty)
- No duplicates found in decisions.md (all 236 headers are unique)
- Label automation implemented by Fenster; documented in team history
Session: 2026-02-13-go-release-labels
Requested by: Brady

Changes:
- Merged fenster-go-release-automation.md from inbox to decisions.md
- Deleted inbox file after merge
- Propagated team update to Keaton and Kobayashi histories (label automation affects architecture and CI/CD)
- No duplicates found; all 236 existing headers remain unique
Session: 2026-02-13-docs-and-scenarios
Requested by: Brady

Changes:
- Logged comprehensive documentation pass (36 files, 5,534 lines)
- Merged 2 decisions from inbox (execution strategy, label taxonomy)
- Deleted inbox decision files after merging
@bradygaster bradygaster merged commit 551438b into dev Feb 13, 2026
@bradygaster bradygaster deleted the squad/30-ssh-agent-hang-fix branch February 13, 2026 16:49
williamhallatt added a commit to williamhallatt/squad that referenced this pull request Mar 16, 2026
…er#341)

46 tests covering 4 features:
- bradygaster#31 Ralph Idle-Watch Mode (RalphMonitor): 11 tests
- bradygaster#47 Client Compatibility (Platform Detection): 16 tests
- bradygaster#45 Reviewer Lockout (deepened): 11 tests
- bradygaster#46 Deadlock Handling (deepened): 8 tests

Combined with batch 1 (PR bradygaster#422) and batch 2 (PR bradygaster#425), automated
tests now cover 11 of 13 ⚠️ Needs Setup features from bradygaster#341.
bradygaster pushed a commit that referenced this pull request Mar 16, 2026
)

SDK feature parity batch 3: 46 tests for casting determinism, universe selection, and overflow handling.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
joniba pushed a commit to joniba/squad that referenced this pull request Mar 26, 2026
…ct, format)

Files cherry-picked from branches squad/2-filter-messages, squad/3-extract-decisions,
and squad/4-format-summary. Original PRs bradygaster#31, bradygaster#32, bradygaster#42 had scope pollution from
the worktree clobbering problem.

Closes bradygaster#2, bradygaster#3, bradygaster#4

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants