A lightweight CLI for explicitly running existing GitHub Actions locally through act.
The revised PRD targets Windows, macOS, and Linux hosts with Docker/Linux-container jobs, download-on-miss and verified dependency reuse. Automatic Git gates are removed; hosted-run suppression is deferred. This is product direction, not an implemented feature claim. Architecture/specs now align with that direction; see current implementation sequencing.
Use AGENTS.md and the documentation index to select
relevant project contracts. The repository-local
Context Engineering skill is installed
from ai-skills PR #6
(merge commit 6ec528e498b51a4e1a9796bb55469bc188e5fdc1). Its local policy
requires meaning-preserving documentation changes; it does not change product scope.
Read the PRD, architecture, execution spec, or implementation plan through their task-specific indexes. Migration evidence records historical source sections, legacy anchors and the later scope alignment.
To validate docs locally (Python standard library only):
python3 scripts/validate_docs.py --checkRequires Go 1.27.2 for development and CI. CI See's own runtime does not
require Node.js, npm, act, Docker or Git for these S1 informational commands.
go build -o ci-see ./cmd/ci-see
go test ./...
go vet ./...
./ci-see --help
./ci-see --versionOn Windows build with go build -o ci-see.exe ./cmd/ci-see and invoke
.\ci-see.exe. Go runs natively inside WSL2 as a Linux executable.
ci-see, ci-see init, and ci-see status are unavailable in S1 and fail
without writing hooks, configuration or validation state. They do not run CI.
| Exit | Meaning |
|---|---|
0 |
Informational success (--help/--version only in S1) |
1 |
Internal error |
2 |
Invalid command/arguments |
3 |
Operation not implemented |
4 |
Reserved by existing S1 code for legacy Git gates |
The existing S1 code reflects the earlier gating design: all its core decisions
block, including caller-supplied PASS. Hook/approval features are removed from
the revised PRD. Real act execution and revised CLI behavior remain unimplemented;
this documentation change does not alter existing exit codes or runtime behavior.