clone

a hermes agent plugin for openspec: tools for spec workflows and a dashboard tab for browsing changes and specs

docs: update README for init endpoint, spec diff view, hash anchors

dami etoile committed 9ea9687
- Remove stale 'repo needs openspec/ directory' claim
- Document source initialization from dashboard
- Mention spec delta side-by-side rendering
- Update hash routing to include tab anchors
- Remove stray closing code fence
commit
9ea96871042e372053e1ac8fde3d0e9c91e2facd
parent
b3203d553c64312b59957d1b72cbf20e67eadfc3
author
dami etoile <dami.etoile@gmail.com>
1 file changed, +4 -4
MREADME.md8++++----
M README.md +4 -4
@@ -29,9 +29,10 @@ This plugin closes both gaps:
2929 **Dashboard tab** (`/openspec`):3030 3131 - Register repos by path — each gets a vanity name and stable tokens (`name/os_a1b2c3`).32-- **Changes view** — Kanban-style board: ideas → draft → todo → in_progress → done → archived. Click any change to read its proposal, tasks, design, and spec deltas.32+- **Changes view** — Kanban-style board: ideas → draft → todo → in_progress → done → archived. Click any change to read its proposal, tasks, design, and spec deltas. Spec deltas render side-by-side (current vs proposed) with structured requirement/scenario parsing.3333 - **Specs view** — browse current specs in the worktree, sorted alphabetically or by last git commit date. Compare against HEAD (dirty mode) or arbitrary git refs (before/after).34-- Deep-linking via URL hash (`#project-name/token`).34+- **Source initialization** — register a repo before it has an `openspec/` directory, then initialize it from the dashboard (runs `openspec init --tools none`, or creates the directory structure as a fallback).35+- Deep-linking via URL hash (`#project-name/token#anchor` — the second `#` selects a tab: proposal, tasks, design, or specs).3536 3637 ![Change board](screenshots/board.png)3738
@@ -61,7 +62,7 @@ To register a repo in the dashboard, open the OpenSpec tab and click **Add sourc
6162 openspec_context(identifier="/path/to/your/repo")6263 ```6364 64-The repo needs an `openspec/` directory. Once registered, the dashboard shows changes and specs live from the filesystem.65+The repo doesn't need an `openspec/` directory upfront — if it's missing, the dashboard shows an **Initialize** button that creates it. Once initialized, the dashboard shows changes and specs live from the filesystem.6566 6667 ## Verify6768
@@ -116,4 +117,3 @@ hermes-openspec/
116117 | `dashboard/plugin_api.py` | All backend API routes and the spec-browser logic |117118 | `dashboard/manifest.json` | Tab registration, entry points |118119 | `dashboard/dist/index.js` | Frontend: board, specs view, source dialogs, deep-linking |119-```