“mkczarkowski”
e95e9a0c78
- .github/workflows/ci.yml: add e2e + e2e-windows jobs with Resend secrets, extend check-windows with build:binary + smoke tests - docs/reference/platform-support.md: update CI testing table to match reality - context/changes/e2e/plan.md: mark phase 5 automated steps complete Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
3.2 KiB
Platform Support
Requirements
- Node 20+ — the only runtime dependency on all platforms.
Supported platforms
| Platform | Install methods | Config location | Clipboard |
|---|---|---|---|
| macOS | npx, npm global, binary | ~/.config/10x-cli/ |
pbcopy |
| Linux | npx, npm global, binary | ~/.config/10x-cli/ (or $XDG_CONFIG_HOME/10x-cli/) |
xclip or xsel |
| Windows | npx, npm global, binary (.exe) | %APPDATA%\10x-cli\ |
clip.exe |
Zero-install usage
On any platform, run directly with npx — no global install needed:
npx @przeprogramowani/10x-cli auth
npx @przeprogramowani/10x-cli get m1l1
Shell recommendations
| Platform | Recommended shell |
|---|---|
| macOS | Terminal.app / iTerm2 (zsh) |
| Linux | Any terminal (bash / zsh) |
| Windows | Windows Terminal + PowerShell — renders ANSI colors and Unicode symbols correctly. Legacy cmd.exe may garble output. |
Clipboard
Skills that copy output to the clipboard work automatically on all platforms. Each skill provides both bash and PowerShell clipboard commands so your AI agent can pick the right one for your shell.
| Shell | Clipboard command |
|---|---|
| bash / zsh (macOS) | pbcopy |
| bash / zsh (Linux) | xclip -selection clipboard |
| bash / PowerShell (Windows) | clip.exe |
| PowerShell (native) | Set-Clipboard |
If no clipboard tool is available (e.g., headless Linux server), the copy fails silently — no error is shown.
To install clipboard support on Linux:
# Debian / Ubuntu
sudo apt install xclip
# Fedora
sudo dnf install xclip
AI tool support
The CLI writes artifacts to the correct directory for your AI coding tool:
| Tool | Skills directory | Rules file | Config templates |
|---|---|---|---|
| Claude Code | .claude/skills/ |
CLAUDE.md |
.claude/config-templates/ |
| Cursor | .cursor/skills/ |
.cursor/rules/10x-course.mdc |
.cursor/config-templates/ |
| GitHub Copilot | .github/skills/ |
.github/copilot-instructions.md |
.github/config-templates/ |
| Codex CLI | .agents/skills/ |
AGENTS.md |
.agents/config-templates/ |
| Windsurf | .windsurf/skills/ |
.windsurfrules |
.windsurf/config-templates/ |
| Generic | .ai/skills/ |
AGENTS.md |
.ai/config-templates/ |
The CLI auto-detects your tool from project markers on first run. Override anytime with --tool:
10x get m1l1 --tool cursor
CI testing
The CLI is tested on both Ubuntu and Windows in CI:
| Test level | Ubuntu | Windows |
|---|---|---|
| Unit + integration | check job |
check-windows job (PowerShell) |
| Smoke (compiled binary) | check job |
check-windows job |
| End-to-end (CLI ↔ production API) | e2e job |
e2e-windows job |
The e2e jobs build the compiled binary, then spawn it as a subprocess against the real production API. Auth is automated via Resend magic-link email retrieval. E2e jobs run after their respective check jobs pass but do not block the fast feedback loop — a flaky e2e failure won't prevent unit test results from appearing quickly.