---
name: openspeccer
description: Use when the user wants to open or browse an OpenSpec project's dashboard, or asks which OpenSpec changes are in flight or how far along one is. Do NOT use for creating, editing, verifying or archiving changes; use the OpenSpec workflow skills for those.
metadata:
  version: 2026-10-08
---

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.