# openspecui > OpenSpec UI - Visual interface for spec-driven development Latest version **14.0.1** (published 2026-10-06) · 0 weekly downloads ## Install ```sh npm install openspecui pnpm add openspecui yarn add openspecui bun add openspecui ``` ## Health **Score 55/100 (C)** — status: active. Positive: no vulnerabilities; recently updated; high maintenance score. Warnings: low downloads; no types; no esm support. ## Facts | | | |---|---| | Version | 14.0.1 | | Published | 2026-10-06 | | First published | 2025-11-25 | | Weekly downloads | 0 | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 0 | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 125 | | Maintainers | kezhaofeng | ## Links - npm: https://www.npmjs.com/package/openspecui - Repository: https://github.com/jixoai/openspecui - Homepage: https://github.com/jixoai/openspecui#readme - Issues: https://github.com/jixoai/openspecui/issues - npm.io page: https://npm.io/package/openspecui ## Recent versions - 14.0.1 (latest) — 2026-10-06 - 6.0.0-beta.1 (beta) — 2026-07-28 - 14.0.0 — 2026-10-02 - 13.0.2 — 2026-09-26 - 13.0.1 — 2026-09-18 - 13.0.0 — 2026-09-12 - 12.0.0 — 2026-09-04 - 11.1.0 — 2026-08-28 - 11.0.0 — 2026-08-28 - 10.0.0 — 2026-08-28 - 9.0.3 — 2026-08-28 - 9.0.2 — 2026-08-18 - 9.0.1 — 2026-08-17 - 9.0.0 — 2026-08-17 - 7.0.2 — 2026-08-14 - … 98 more at https://npm.io/package/openspecui/versions ## README # OpenSpecUI A visual interface for [OpenSpec](https://openspec.dev) — the visual projection and operator for spec-driven development with AI agents. OpenSpecUI 14 gives OpenSpec projects a reactive dashboard, an objective change workflow, a config workbench, real terminals, and static export — while the OpenSpec CLI stays the source of truth for every workflow fact. ## Requirements - **OpenSpec CLI**: `>=1.14.0 <1.15.0` — the stable 1.14 line is current and recommended (single-series window). Older lines (including the 1.13.x OpenSpecUI 13 window), prereleases, and `>=1.15.0` are blocked by default. - **Node.js**: `>= 20.19.0` ```bash npm install -g @fission-ai/openspec@1.14 ``` ## Quick start ```bash # Recommended: run without a global install npx openspecui@latest bunx openspecui@latest # Optional: install globally npm install -g openspecui openspecui ``` The bare command is an alias for `serve`. It starts the project backend; if a local App daemon is already running, the project is attached to its **Workspaces**. Otherwise an interactive terminal asks `Start OpenSpecUI App? [Y/n]`, and non-interactive execution opens **Direct Project Web** at `http://localhost:3100`. ## Three surfaces **Native App** — a user-level App daemon hosts the bundled same-version App shell in a retained OpenTray window with a tray icon. Workspaces keep multiple projects in one place (favorites, recents, a task manager for running backends) alongside environment-scoped Stores. ```bash openspecui start # start/activate the App daemon (native OpenTray host) openspecui start --web # same daemon, Browser host instead openspecui stop openspecui restart ``` **Direct Web** — one explicit browser surface for the current project, no daemon required. ```bash openspecui --web ``` **Static export** — a deployable snapshot for docs hosting or offline review; search keeps working from a worker index, no backend needed. ```bash openspecui export -o ./dist openspecui export -o ./dist --base-path /docs --clean ``` ## Command reference | Command | Description | | ------------------------------------------- | ------------------------------------------------------------------------------------------------ | | `openspecui [project-dir]` | Serve a project (alias of `serve [project-dir]`) | | `openspecui serve [project-dir]` | Start the project backend and own its Server | | `openspecui --app` | Ensure the App daemon is running and attach the project as a Workspace | | `openspecui --web` | Open Direct Project Web; also attach when a daemon is already running | | `openspecui --no-open` | No prompt, no daemon start, no Workspace registration, no browser | | `openspecui --auth` | Generate a 256-bit Bearer credential for the whole access gate | | `openspecui --password ` | Use an operator secret instead of a generated credential | | `openspecui --port ` | Project web port (default 3100) | | `openspecui start / stop / restart [--web]` | Manage only the user-level App daemon, never project Servers | | `openspecui export -o ` | Static export; `-f html\|json`, `--base-path`, `--clean`, `--open`, `--references include\|omit` | | `openspecui --otel --otel-endpoint ` | Backend OpenTelemetry tracing | URL-valued App mode is not supported: the daemon always serves the App shell bundled with the same CLI release. ## What's inside - **OPSX change workflow** — kanban lanes over tracked task phases with Continue / Fast-forward / Apply / Verify / Archive operators driven by live CLI evidence; admitted sessions load the whole change status list in one `status --all` spawn - **Change evidence** — MODIFIED deltas can present the CLI's own requirement diff and warning evidence (`show --diff`) beside the local delta projection, validation findings reports (`validate --report findings`) with informational merge-conflict findings, `status` advisory warnings as a collapsed direct-plane summary row, Apply task `sourcePath`/`line` source locations, spec requirement/scenario names from `show --type spec`, and per-entry `archived` inventory facts from `list --archived`/`--all` - **Dashboard** — active changes with CLI-owned applying progress and a curated Code Git snapshot - **Config workbench** — route-backed owners for project binding, active root, environment globals, and schemas, plus an adaptive setup guide and `init --language` on the admitted CLI line - **Agent delivery** — the CLI-owned registry projects per-version agent commands and skills across fifty tools on the 1.14 series, including the ten 1.14 additions (amp and gsd on the shared `.agents` skills root, IBM Bob, and more), SourceCraft Code Assistant (from 1.12, `.codeassistant`), Zed, and the Antigravity `.agent` → `.agents` migration - **Terminals** — multi-tab PTY sessions (xterm and ghostty-web) with direct agent send - **Git view** — commits, patches, and worktrees with explicit code/planning scope - **Search** — reactive in live mode, worker-backed in static exports - **Reactive kernel** — native file watching with push-notify / pull-refresh projections ## Project hooks Project-local hooks live in `openspec/openspecui.hooks.ts`, outside persisted UI config. Types ship with this package: ```ts import type { OnReadDocumentHookV1, OnRunWorkflowHookV2 } from 'openspecui/hooks' export const onReadDocument: OnReadDocumentHookV1 = async (ctx, read) => { const result = await read() if (ctx.document.kind !== 'spec') return result return { ...result, watchFiles: ['openspec/glossary.md'] } } export const onRunWorkflow: OnRunWorkflowHookV2 = async (ctx, run) => { const result = await run() if (result.kind !== 'agent-prompt') return result return { ...result, text: `${result.text}\n\nPlanning root: ${ctx.target.planningRoot.path}` } } ``` See the repository README for the full hook contract. ## Links - Website: - OpenSpec: - Source and full documentation: MIT License — see the repository for details. --- _Source: https://npm.io/package/openspecui · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._