Menu
Workaround for installing Squad SDK from GitHub branches that don't have dist/ committed
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
{what this skill teaches agents}
Guide for using the Rally CLI tool to dispatch AI agents to GitHub issues and PR reviews via git worktrees. Use this when working with Rally dispatches, the dashboard, or managing worktrees.
Hard-won patterns for building fullscreen terminal UIs with Ink 5 + React. Covers useInput race conditions, fullscreen rendering, sub-view switching, and testing with ink-testing-library.
Pattern for running multiple sub-agents in parallel using git worktrees. Use this when working on multiple issues/PRs simultaneously.
Dual-review PR workflow: Copilot automated code review + Mal manual team review. All comments must be addressed (fix or explain). Out-of-scope work opens GitHub issues with @copilot assignment.
Proven process for technical design phases: resolve blockers upfront, engage stakeholders early, validate against reality before team review, spec test frameworks before implementation, scope features explicitly.
| name | squad-sdk-local-build |
| description | Workaround for installing Squad SDK from GitHub branches that don't have dist/ committed |
| confidence | high |
When installing the Squad SDK (@bradygaster/squad) from a GitHub branch, npm does NOT:
prepare scripts that require devDependencies (like TypeScript)This means branches without a committed dist/ folder will fail to import because the compiled JavaScript doesn't exist.
Error symptom:
Cannot find module '@bradygaster/squad/packages/squad-sdk/dist/index.js'
| Flag | What it does | Why it doesn't help |
|---|---|---|
--include=dev | Installs YOUR project's devDeps | Doesn't affect installed package's devDeps |
--install-links | Changes symlink handling | Doesn't trigger build scripts |
| Global TypeScript | Makes tsc available | npm doesn't run prepare for GitHub tarballs |
Clone the SDK repo locally and build it:
cd /tmp
git clone https://github.com/jsturtevant/squad-pr.git
cd squad-pr
git checkout consult-mode-impl
npm install
npm run build
Update package.json to use the local path:
npm pkg set dependencies.@bradygaster/squad="file:/tmp/squad-pr"
npm install
Verify:
ls node_modules/@bradygaster/squad/packages/squad-sdk/dist/
# Should show: index.js, index.d.ts, etc.
dist/setupConsultMode() or other new features aren't in the published npm versionThe SDK team should do ONE of:
dist/ to branches — simplest, works immediatelyprepublishOnly that builds — already exists, but only runs on npm publishpackage.json uses file:/tmp/squad-pr/tmp/squad-pr includes dist/ folder