openspeccer

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 1. Create a task per step below, each with its completion criterion, then work through them. 2. Find the repo: pass the user's repo path, or omit it and the script searches upward from the current directory for `openspec/`. 3. For a status question ("what's in flight?"), run `serve.py <repo> --summary` and answer from its output. For one change's artifacts and tasks, use `--change <slug>`. `--json` prints the whole snapshot; send it to a file and read only what you need. Done once you have answered, with no server started. 4. If the user wants the dashboard, start `serve.py <repo>` as a background process. Done when a line containing `serving <name> at <url>` appears, or the process exits; on exit, report its stderr to the user. 5. Always give the user the URL. Pass `--no-open` in headless or remote sessions, and when re-running against a server that is already up. 6. 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`, set `OPENSPECCER_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.