openspeccer
Installation
SKILL.md
openspeccer is a read-only local web dashboard for any repository holding an openspec/ directory. It is stdlib Python and needs no install. Run <this-skill-dir>/scripts/serve.py --help for every option.
Workflow
- Create a task per step below, each with its completion criterion, then work through them.
- Find the repo: pass the user's repo path, or omit it and the script searches upward from the current directory for
openspec/. - For a status question ("what's in flight?"), run
serve.py <repo> --summaryand answer from its output. For one change's artifacts and tasks, use--change <slug>.--jsonprints the whole snapshot; send it to a file and read only what you need. Done once you have answered, with no server started. - If the user wants the dashboard, start
serve.py <repo>as a background process. Done when a line containingserving <name> at <url>appears, or the process exits; on exit, report its stderr to the user. - Always give the user the URL. Pass
--no-openin headless or remote sessions, and when re-running against a server that is already up. - To stop it, end the background process you started, using the PID or task handle you captured at launch.
Gotchas
- Re-running for the same repo reuses the running server and prints
already serving, so step 4 is safe to repeat. - A server you did not start (no handle from this session) belongs to the user. Leave it running.
- The OpenSpec CLI is optional and only feeds the Schemas and Commands pages. Without it, only project schemas show and Commands is empty. For a CLI outside
PATH, setOPENSPECCER_OPENSPEC_BIN. - Active changes from every git worktree are aggregated by default.
- The page updates as files change, so there is nothing to refresh after editing artifacts.