Skip to content
| Marketplace
Sign in
Visual Studio Code>Other>SpecViber for VS CodeNew to Visual Studio Code? Get it now.
SpecViber for VS Code

SpecViber for VS Code

Inducera AB

|
2 installs
| (0) | Free
VS Code surface for SpecViber — bring your SpecViber workspace, action specs, checklists, comments, notes and relations into the editor. Requires an existing SpecViber instance (specviber.com).
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

SpecViber for VS Code

See your Agent Chats alongside the ActionSpecs, tasks and documents they move forward. SpecViber brings chats from Claude Code, Codex and GitHub Copilot together in VS Code, with work status, history and a way back to the conversation.

SpecViber overview

Stay in control as your AI project grows

AI coding creates momentum. As the project grows, decisions, unfinished work and verification can become harder to follow than the code is to generate.

SpecViber gives you and your coding agents a shared method. You set direction and review the consequential choices. Your agents maintain the plan, execute the work, record progress and run the checks they can. The project remains understandable across Agent Chats and across supported assistants such as GitHub Copilot, Codex and Claude Code.

The extension connects Agent Chats in the apps you use to the project work they change. An ActionSpec holds a plan and verification checklist that your agents maintain. Follow it or a task across agents, see its progress and return to the chat behind it. View the work on the web app's Kanban board or explore its connections in the Context Navigator relation graph.

Kanban and relation graph preview

What the extension brings into VS Code

Agents — your chats and the work they move forward

Open Agents for one overview of Agent Chats from Claude Code, Codex and GitHub Copilot on your PC, across their supported apps and IDE integrations. Choose This project or All projects to see which agents are running, waiting for you or idle and ready to continue, together with the ActionSpecs, tasks and documents they have worked on.

Agents overview with running and recent chats, subagents and their project work

  • Follow the work. Each chat brings its work objects, their status and the agent's latest answer together. Expand subagents to see their activity too.
  • Find a conversation across providers. Search chat and work-object names, displayed answer text, agent, project, status or document/task ID in the same list.
  • Resume the chat. Use Open to return to the conversation in its client, with VS Code or desktop destinations where supported. You can also reach earlier chats from an object's Agent History.
  • Keep your list useful. Star chats, add personal notes and mark finished conversations done. Choose Not Done to keep those chats out of your working list, or Done to find them again.

Explore agent work in the Context Navigator

Click a chat's graph button to open its linked SpecViber work in the web app's Context Navigator. See the ActionSpecs, tasks and documents that chat changed, then expand their relations to follow the surrounding project context. The graph connects the conversations to the plans, decisions and results that move the project forward.

Context Navigator showing related ActionSpecs, a test report and agent chat badges

Use Agents in the graph to show chat badges and the Agent Chat list. From a work object, inspect its agent activity or reopen your chat; from a chat, explore its work objects. Move between the Kanban overview and these relations as you follow progress or choose what to continue.

One navigator for documents and tasks

Navigator Sidebar preview

Alongside Agents, the activity-bar navigator has three views for project work:

  • Docs / ASpecs — browse, search and filter registered markdown by status, type, area, repo, priority, audit state or personal star.
  • Tasks — follow and filter tasks by status, priority, type and personal star.
  • All — see documents and tasks together, or narrow the list to ActionSpecs and tasks.

You can sort by activity or creation date, jump to a document by #D… ID, create tasks and run a workspace rescan. A user-started rescan registers new project documents and creates one AI classification task when there is new material to assess. Status and priority chips are editable directly in the list, with lifecycle-valid choices for each item. Personal stars belong to you; priority is available only where it has work meaning — ActionSpecs and tasks.

A SpecViber-aware document viewer

Document Viewer preview

Open a tracked markdown file as a rendered document with outline, find, inline @comments and multi-state checkboxes: todo, in progress, done, dropped, blocked and needs research. Left-click advances ordinary checkbox work; right-click selects an exact state.

From the document you can also comment on a checklist item, create or promote a task, create a child spec, change item ownership and open the relation graph. File-changing actions stop when the source has unsaved edits, so the extension does not overwrite your editor buffer.

Choose Open With… → SpecViber Viewer for any .md file, or use Edit with Preview for source and rendered content side by side with scroll sync.

Document and task properties

Document Properties preview

The document properties panel includes status, type, areas, ActionSpec priority, quality, relevance, summary, checklist, relations, linked tasks, inline comments, notes, history, personal star and audit-action state. An unregistered markdown file can be registered from the same panel.

The task panel includes editable status, type, priority, area, title and description, together with tags, linked documents, comments and interactive task-description checkboxes. Completing the final open item offers the appropriate close or waiting state instead of silently declaring the work finished.

Agent Chat controls and status

Reading the timeline, managing chats and reopening work

The navigator's Agents tab reads the Claude Code, Codex and Copilot Agent Chat transcripts on this machine. Active now keeps working and waiting agents at the top, followed by Recent Agent Chats. Within these groups, cards keep their reading order during updates; activity timestamps re-sort them when a chat starts or stops running, or you change the project scope or period. New idle chats are appended without moving existing cards. Agent Chat names appear when the client stores one locally; summaries are labelled. Verbose shows document/task names and the ending preview immediately; it does not load full answers for every expanded card. Compact shows the same full cards for working/waiting and newly idle Agent Chats; older cards start collapsed. The card heading's single chevron expands or collapses both names and the answer together. Click an object's name to open it. Each name shows its status; hover over or focus it for the rest of what the Docs and Tasks lists show: type, priority, checklist progress, comments, areas or tags, and the audit flag. An ID expands a collapsed card; on an expanded card it copies the ID and briefly confirms the copy beside it. The agent-icon History link opens Agent History, newest first, with the full object title prominently shown. Search Agent Chat and object names, answer excerpts, agent, project, status or T/D ID. Expanded cards show the ending of the latest answer as Markdown in a compact preview without an internal scrollbar. Earlier text clips upward so the final question or next step stays visible. View beginning reads the full answer locally on click and opens it from the start with a scrollbar. View end returns to the ending preview. Your reading position in full view stays in place during live updates. An internal 256 KiB limit protects against unusually large answers: both the start and end remain readable, with an explicit notice where the middle was omitted. Hover over an expanded card to show the Latest user message button (a person and a speech bubble) between its documents and the answer: it opens the last message you wrote in that Agent Chat, in full and with its time, and Previous and Next step through your earlier messages. Only your own messages count; tool results, subagent prompts, notifications and context the client adds are left out. The text is read when you open it. Idle means the last turn finished, not that the Agent Chat is closed; a yellow Newly label marks the first minute after the turn ends. All projects shows the project name on each card where it is known. Only object IDs are sent to fetch names and details; Agent Chat content and names stay in VS Code.

Subagents count as the Agent Chat's work. For Claude Code, Codex and Copilot CLI, an Agent Chat whose main agent is idle while a subagent works shows running · 2 subagents, and the tab's running indicator stays on; a question waiting for you still shows as waiting for you · 1 subagent running. Main agent and the Subagents disclosure share one row. Their status labels are muted so the chat's overall Running stands out. Fold out Subagents for each agent's status, name or task and latest activity, working ones first. Documents and tasks a subagent changed appear on the Agent Chat's card, and answer text has its own shaded frame. A subagent that has been quiet for over 10 minutes without finishing is stale; it does not keep the Agent Chat running, and once the main agent has continued it no longer decides the Agent Chat's status. Copilot Agent Chats in VS Code's own chat storage show no subagents yet.

Your own markers help you sort the list. ✓ marks an Agent Chat done for yourself: it leaves Not Done but changes no task or document, does not stop the agent and archives nothing in Claude Code, Codex or Copilot. It is offered when the Agent Chat is not running or waiting for you. ☆ stars an Agent Chat. Hover over or focus the card to reveal ✎ at the end of its heading; it adds or edits a short note, shown directly after the title in pale yellow in a dark theme. Choose All, Not Done, Done, Starred or Reply: Not Done shows unmarked Agent Chats, every running or waiting Agent Chat, and Agent Chats marked done that have New activity since; Mark done again or Restore settles those. Agents starts at All each time VS Code starts, and keeps your choice until VS Code closes. A short message over the list confirms each marker change, with Undo right after ✓; a card that leaves the list you chose fades out. Opening, renaming or changing an Agent Chat's settings is not new activity. Markers are stored only in this VS Code profile (not synced, never sent to SpecViber), apply in every window and in All projects, and are kept when an Agent Chat's transcript is no longer found.

Reply attention helps you find chats that need an answer. Choose the Reply filter to show chats waiting for an answer or approval and visible Reply? hints, even if you marked the chat done. Combine it with text search, or search for reply or waiting for answer. Dismissed hints leave the filter immediately. Waiting for reply identifies an unanswered Claude Code question, and Approval needed identifies a Claude Code plan approval or a Copilot CLI permission request, a subagent's included. Reply? is a possible question or request for a reply in the last completed answer from Claude Code, Codex or Copilot CLI. It can be wrong, including for rhetorical questions: use × beside it to dismiss just that hint. A new answer can show a new hint. Text hints cover Swedish and English answers up to 8 KiB; longer answers and the older Copilot chatSessions format are left unclassified. Codex has no confirmed question signal in this version. Hints also appear in Compact and with answer previews hidden; they change no running status, personal done marker or card order. The Agents tab adds a yellow dot and separate confirmed/possible counts in its tooltip, alongside the green running indicator. All classification stays on this machine; dismissals store only chat/evidence identities and time in this VS Code profile.

Open followed by the agent icon reopens that card's Agent Chat. A single destination opens directly; otherwise a popup offers Codex · VS Code and Codex · Desktop app, or the corresponding client and destinations. Arrow keys select a destination; Escape closes the popup. Related earlier chats are available through History. The document/task panels use the same destination names. If the Agent Chat belongs to another project, choose Open that window or the app alternative. A successful handoff is quiet; a rejected IDE handoff offers the same Agent Chat in the app, plus the pickup prompt when the Agent Chat has an associated object.

Verify ▾ appears to the left of Open while you hover over or focus the card, and lets another agent check what this Agent Chat did; Open keeps its place. Copy verification prompt puts a review prompt on the clipboard: the Agent Chat's client, name, period and the documents and tasks it changed, your latest message in it, and instructions to check the work objects, the Git commits and the tests without changing anything. Paste it into a new Agent Chat yourself, preferably in another client. The agent's own final reply is left out on purpose, so the reviewer forms its own view first. Once the reviewer has reported, Copy latest agent reply gives you that reply to paste as a next message, so the reviewer can compare the agent's claims with its findings. The button confirms each copy. Your message and the reply are included only with Show Preview on. Nothing is sent anywhere.

Copilot · VS Code reopens Copilot Agent Chats in the VS Code window for their project, including Agent Chats stored by the Copilot CLI harness. This works from Agents and the document/task panels without the experimental setting.

A green dot on the Agents tab means at least one Agent Chat is running in the selected project scope. The tooltip gives the count. Search and object-history filters do not affect it; waiting and idle Agent Chats do not light it. Status follows changes while the navigator is visible, including on Docs / ASpecs, Tasks and All. Object names and answer previews are requested only when the timeline is visible. Monitoring stops when both the navigator and timeline panel are hidden.

A document or task the Agent Chat wrote to glows orange for up to 25 seconds after its latest write, on the expanded name or the folded ID badge. Each write restarts its own window; the glow stops when the turn finishes. Unfinished permission waits keep the remaining glow. With reduced motion enabled, the colour stays steady.

The agent menu on every task and registered document — navigator rows in Docs / ASpecs, Tasks and All, the document viewer's toolbar and the task and document panels — opens beside its button, with the same grouped layout as the web app: back to your own Agent Chat on this machine that changed the object, a new Agent Chat with the pickup prompt, or the object's Agent History (the timeline filtered to it) and Open in browser (everyone's Agent Chats on the web app's Agents page). The task header labels the button Open followed by the agent icon; other surfaces use Agents or the agent icon. This menu covers chat opening and history in both object panels. Agent History has ← Back to return to all chats. An ordinary document gets a document prompt, not the action-spec workflow. Opening the menu changes no status. Navigator rows also show ● Running or Waiting when one of your Agent Chats on this machine is working on the object or waiting for you; this comes from the timeline's own reading and is never sent anywhere.

Send to agent… in the viewer's text-selection menu and in a checklist item's ⋯ menu takes the selected text, or the item with its description, to a new Agent Chat or one of your earlier Agent Chats for the same document. The selection menu always offers it for readable text in a registered document, next to Comment, Add task and Highlight where those apply. The same popup shows the editable excerpt and optional instruction together, above the client choices. Your draft remains available if you cancel and reopen it. Where a client's link is verified to fill in text, the Agent Chat opens with the text in its input; otherwise the action says Copy text and open …, puts the whole text on the clipboard and opens the Agent Chat. An earlier Claude Code Agent Chat gets the text filled in when it is closed, and the text is also copied: Claude Code does not fill a chat that is already open, and says so. Nothing is ever sent for you: you review the text and send it yourself. The text stays on this machine, is never cut short, and works in read-only documents too; it does not change the item's state or who it is assigned to.

The supported setup order: MCP first, extension last

The extension is the final step in SpecViber setup. It does not create the workspace or install and start the MCP server for you.

  1. In the SpecViber web app, create or open your workspace and complete its Setup guide.
  2. Let the guide install or detect the local client, then run Generate token & configure locally. This writes the project-local, gitignored .vscode/mcp.json while preserving other MCP servers.
  3. In VS Code, run MCP: List Servers, select specviber from .vscode/mcp.json, choose Start Server, approve trust if asked and wait until it shows Running. A same-name entry from .mcp.json shown as Disabled is the expected deduplicated fallback; do not start both.
  4. Run the onboarding prompt in a new Agent Chat and confirm that specviber_dashboard reaches the correct workspace.
  5. Install SpecViber for VS Code from the Marketplace and run Developer: Reload Window.

That is the complete extension setup. When the MCP setup is already working, the extension configures itself from the same .vscode/mcp.json: API URL, local content URL, workspace ID and workspace credential all come from that one validated source. There is nothing to copy into VS Code Settings.

The running MCP server is the readiness check for the project setup; the extension itself reads the MCP registration file rather than querying the process for connection details. If .vscode/mcp.json is regenerated later, the extension notices the change and rebinds the workspace connection. You can also run SpecViber: Reload Workspace Connection.

Requirements

  • an active SpecViber workspace — start at specviber.com
  • the local SpecViber client and content API, installed by the workspace Setup guide
  • Node.js 18+ for the MCP server
  • VS Code 1.85+
  • a supported coding-agent setup; for the VS Code flow above, GitHub Copilot with the specviber MCP server showing Running

No manual configuration in the normal flow

A valid specviber entry in .vscode/mcp.json is authoritative and atomic. The extension never mixes part of that entry with stale VS Code settings. A present but incomplete entry is reported as an error with the fields that need to be regenerated.

The workspace credential is not a VS Code setting. The extension imports it from the gitignored MCP registration and keeps a connection-bound copy in VS Code SecretStorage, so a credential for one API/workspace pair is not reused for another.

Manual Workspace Settings remain available only as an advanced fallback for local development or installations that have no generated specviber MCP entry:

Setting Purpose
specviber.apiUrl Metadata API base URL
specviber.contentUrl Local content API base URL in split/SaaS mode
specviber.workspaceId Workspace used by extension commands

The day-to-day view preference Show SpecViber system documents lives behind the gear in the Docs / ASpecs and All filter rows and is saved for the current workspace.

If something is wrong

Symptom What to do
The SpecViber sidebar does not load for this project Open the configured project folder, confirm .vscode/mcp.json exists, enable the extension and reload the window
MCP is not Running Run MCP: List Servers, start specviber from .vscode/mcp.json and approve project trust
Not connected for this folder Open the workspace's Setup guide and run Generate token & configure locally
Local configuration is incomplete Regenerate it from the web app; do not fill the missing fields from old VS Code settings
Authentication was refused Regenerate the connection for this workspace; its credential cannot be reused for another workspace
The local SpecViber client did not respond Start the local web server that serves the client, then use Check again in workspace Setup

The connection belongs to the project folder. To work in another workspace, open that workspace's configured project folder; the extension deliberately does not reuse the current credential in a workspace picker.

Data boundary

Your source code and markdown files remain in your project and are read or written through the local content API. The hosted service coordinates metadata needed for the shared workflow, including document and task identities, classifications, statuses, relations, checklist text and history. Your chosen AI provider receives the context supplied to it while you use that agent; SpecViber does not control that provider's data handling.

Agent Chat transcripts, names, answer previews and your personal chat stars, notes and done markers stay on this machine. The extension reads supported clients' local transcripts; it sends object IDs to SpecViber to look up project metadata.

Commands

  • SpecViber: Document Properties — open metadata and workflow controls for the current markdown file
  • SpecViber: Document Viewer — open the rendered SpecViber-aware view
  • SpecViber: Edit with Preview — split raw markdown and live preview
  • SpecViber: Open Document by ID — open a document by #D… ID
  • SpecViber: Open Properties by ID — open properties without first locating the file
  • SpecViber: Reload Workspace Connection — re-read .vscode/mcp.json and rebuild the connection
  • SpecViber: Open Web UI (Kanban, relation graph & more) — continue in the full web app
  • SpecViber: Open Local MCP Configuration — inspect this folder's .vscode/mcp.json
  • SpecViber: Open Workspace Settings (advanced) — open the manual fallback settings
  • SpecViber: Reset Stored Credentials — clear extension-cached credentials and import the current registration again on the next authenticated action
  • SpecViber: Open Agents — the Agents timeline in an editor tab

Learn more

  • specviber.com — product overview, access and workspace setup

For extension development and release work, use the repository's dedicated development loop and release runbook rather than this Marketplace README.

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft