#22091: docs(readme): add Windows-native dev gateway command
docs
gateway
scripts
size: M
Cluster:
Windows Gateway Enhancements
## Summary
Describe the problem and fix in 2–5 bullets:
- Problem:
- Why it matters:
- What changed:
- What did NOT change (scope boundary):
## Change Type (select all)
- [x] Bug fix
- [ ] Feature
- [ ] Refactor
- [x] Docs
- [ ] Security hardening
- [ ] Chore/infra
## Scope (select all touched areas)
- [ ] Gateway / orchestration
- [ ] Skills / tool execution
- [ ] Auth / tokens
- [ ] Memory / storage
- [ ] Integrations
- [ ] API / contracts
- [ ] UI / DX
- [ ] CI/CD / infra
## Linked Issue/PR
- Closes #
- Related #
## User-visible / Behavior Changes
List user-visible changes (including defaults/config).
If none, write `None`.
## Security Impact (required)
- New permissions/capabilities? (`Yes/No`)
- Secrets/tokens handling changed? (`Yes/No`)
- New/changed network calls? (`Yes/No`)
- Command/tool execution surface changed? (`Yes/No`)
- Data access scope changed? (`Yes/No`)
- If any `Yes`, explain risk + mitigation:
## Repro + Verification
### Environment
- OS:
- Runtime/container:
- Model/provider:
- Integration/channel (if any):
- Relevant config (redacted):
### Steps
1.
2.
3.
### Expected
-
### Actual
-
## Evidence
Attach at least one:
- [ ] Failing test/log before + passing after
- [ ] Trace/log snippets
- [ ] Screenshot/recording
- [ ] Perf numbers (if relevant)
## Human Verification (required)
What you personally verified (not just CI), and how:
- Verified scenarios:
- Edge cases checked:
- What you did **not** verify:
## Compatibility / Migration
- Backward compatible? (`Yes/No`)
- Config/env changes? (`Yes/No`)
- Migration needed? (`Yes/No`)
- If yes, exact upgrade steps:
## Failure Recovery (if this breaks)
- How to disable/revert this change quickly:
- Files/config to restore:
- Known bad symptoms reviewers should watch for:
## Risks and Mitigations
List only real risks for this PR. Add/remove entries as needed. If none, write `None`.
- Risk:
- Mitigation:
<!-- greptile_comment -->
<h3>Greptile Summary</h3>
Adds Windows-native support for `pnpm gateway:watch` and extracts gateway startup configuration into a separate module.
Changes include:
- Created `scripts/gateway-watch.mjs` to handle platform-specific watch behavior (stops daemon on Windows before starting watch mode to avoid port conflicts)
- Refactored startup config logic from `server.impl.ts` into new `startup-config.ts` module
- Added test for gateway method catalog consistency
- Updated README with mermaid architecture diagram and Windows-specific notes
- Renamed `BASE_METHODS` to `CORE_GATEWAY_METHODS` for clarity
The Windows watch flow differs from Unix: it runs `gateway run --bind loopback --port 18789 --allow-unconfigured` instead of `gateway --force`, providing more explicit configuration.
<h3>Confidence Score: 5/5</h3>
- Safe to merge - clean refactoring with platform compatibility improvements
- Clean code extraction, no logic changes in refactoring, adds helpful test coverage, and improves Windows developer experience without affecting existing Unix/Linux/macOS behavior
- No files require special attention
<sub>Last reviewed commit: 6859bff</sub>
<!-- greptile_other_comments_section -->
<!-- /greptile_comment -->
Most Similar PRs
#22154: dev(watch): make gateway watch portable on native Windows
by Kansodata · 2026-02-20
91.6%
#22926: feat(gateway): add Windows-native watch DX and tool/channel observa...
by Kansodata · 2026-02-21
88.1%
#11470: fix: prevent gateway:watch race by passing --no-clean to tsdown
by apetresc · 2026-02-07
76.4%
#18493: making pnpm build:ui and pnpm build to work on windows
by darkpowerxo · 2026-02-16
75.9%
#8260: fix(macOS): gateway readiness detection + reversible Configure later
by xksteven · 2026-02-03
74.4%
#23355: Gateway: fail closed on untrusted proxy headers
by bmendonca3 · 2026-02-22
73.8%
#17054: Gateway: add commands.list method
by advaitpaliwal · 2026-02-15
73.2%
#5077: fix(windows): implement reliable gateway restart via schtasks helper
by romeoscript · 2026-01-31
73.2%
#5496: Fix: Windows path separators stripped in Gateway scheduled task
by giuliozelante · 2026-01-31
73.1%
#23364: Gateway: add risk-ack interlock for dangerous Control UI flags
by bmendonca3 · 2026-02-22
73.0%