Skip to content

Add copilot-setup-steps.yml for GitHub Copilot cloud environment#1034

Merged
drewvolz merged 8 commits intomasterfrom
drew/copilot-setup-steps
Apr 9, 2026
Merged

Add copilot-setup-steps.yml for GitHub Copilot cloud environment#1034
drewvolz merged 8 commits intomasterfrom
drew/copilot-setup-steps

Conversation

@drewvolz
Copy link
Copy Markdown
Member

@drewvolz drewvolz commented Feb 15, 2026

This PR adds a copilot-setup-steps.yml workflow file to configure GitHub Copilot's cloud development environment.

Copilot Setup Changes

  • Added .github/workflows/copilot-setup-steps.yml with setup steps for the Copilot coding agent
  • Use mise for Node.js setup (installs Node 24.11.0 per mise.toml, consistent with CI)
  • Install npm dependencies
  • Run mise run typecheck for TypeScript compilation and validation

Mise Configuration Fixes

Fixed broken mise task dependencies:

  • Added missing [tasks.build] - runs tsc --build . (matches npm run build)
  • Added missing [tasks.build:watch] - runs tsc --build --watch . (matches npm run build:watch)
  • Removed broken [tasks.watch] which was referencing non-existent tasks
  • Kept [tasks.typecheck] for semantic distinction (validation context vs build context)

Documentation Updates

Updated README.md:

  • Fixed Node.js prerequisite from v20.17 to v24.11.0 (matching mise.toml)
  • Replaced broken mise run watch with working watch commands
  • Documented mise run build:watch and mise run start:watch for development

Updated .github/copilot-instructions.md:

  • Fixed watch command reference (removed non-existent scripts/watch.js)
  • Updated to reflect current working watch commands

Why

GitHub Copilot can now run this repository in the cloud with proper environment setup. The workflow automatically runs when the file is modified to validate it works correctly.

Documentation

See: https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent/customize-the-agent-environment

Configure GitHub Copilot coding agent with:
- Node.js 24.11.0 (matching project mise.toml)
- npm dependency caching and installation
- TypeScript build step

This allows Copilot to run in the cloud with proper environment setup.
Replace actions/setup-node with jdx/mise-action to ensure:
- Node.js 24.11.0 is installed per mise.toml
- Consistent tooling environment with local dev and CI
- mise run typecheck handles both compilation and type validation
- Add [tasks.build] for tsc compilation (matches npm run build)
- Add [tasks.build:watch] for watch mode (matches npm run build:watch)
- Remove broken [tasks.watch] which referenced non-existent tasks
- These tasks ensure mise run build/build:watch work correctly

Note: [tasks.typecheck] is intentionally kept for semantic distinction
(typecheck for validation, build for compilation) even though both run tsc --build
- Update Node.js prerequisite from v20.17 to v24.11.0 (matching mise.toml)
- Replace broken `mise run watch` with working alternatives:
  - `mise run build:watch` for TypeScript compilation
  - `mise run start:watch` for server auto-restart
- Document that these should run in separate terminals
TypeScript requires --build to come before --watch.
Changed from: tsc --watch --build .
Changed to: tsc --build --watch .
- Remove reference to non-existent scripts/watch.js
- Update to reflect current working watch commands
@drewvolz drewvolz added this pull request to the merge queue Apr 9, 2026
Merged via the queue into master with commit b2b2995 Apr 9, 2026
7 checks passed
@drewvolz drewvolz deleted the drew/copilot-setup-steps branch April 9, 2026 02:36
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.

2 participants