attune-gui Plugin

⚠️ This repository is archived

The attune-gui Claude Code plugin has moved into the attune-docs marketplace alongside attune-help and attune-author.

New install:

claude plugin marketplace add Smart-AI-Memory/attune-docs
claude plugin install attune-gui@attune-docs

No further updates will be published here. See Smart-AI-Memory/attune-docs for the current source.

---

A Claude Code plugin that launches the attune-gui dashboard in the Cowork preview pane with a single command — or hands-free when you ask the model to "open the dashboard".

What you get

The dashboard's Cowork sidebar (server-rendered Jinja2, ships with the PyPI package — no npm step):

• Health — cross-layer version + import probe of attune-rag, attune-help, attune-author, attune-gui, plus a corpus snapshot
• Templates — markdown templates with mtime staleness, tags, AI-generated vs. manually-pinned filter, and a per-row pin toggle
• Specs — feature specs in specs/<feature>/ with phase + status badges and direct links to each phase file
• Summaries — inline-editable summaries.json with regen-overwrite warning
• Living Docs — workspace editor, scan trigger, document health, review queue, and RAG quality bars
• Commands — run any registered attune command from a card grid
• Jobs — history with per-feature progress, last-output column, Cancel button, and auto-refresh

The legacy React UI is still available at /legacy/.

Requirements

• Claude Code with Cowork (preview pane support)
• uv on your PATH
• attune-gui >= 0.3.0 installed (pip install attune-gui) or the repo cloned locally

Install

Add the marketplace source to ~/.claude/plugins/known_marketplaces.json:

"attune-plugins": {
  "source": {
    "source": "github",
    "repo": "Smart-AI-Memory/attune-gui-plugin"
  },
  "installLocation": "~/.claude/plugins/marketplaces/attune-plugins",
  "lastUpdated": "2026-05-04T00:00:00.000Z"
}

Then install the plugin:

/plugin install attune-gui@attune-plugins

Usage

Two ways to launch:

Slash command — explicit:

/attune-gui

Natural language — the skill's trigger description picks up phrases like:

open the dashboard
show me living docs
launch the attune-gui dashboard

Either path runs the same logic:

1. Detects your attune-gui project path (current directory or ./attune-gui/)
2. Writes .claude/launch.json with the correct uv run configuration (idempotent)
3. Calls mcp__Claude_Preview__preview_start — Cowork starts the sidecar and opens the dashboard in the preview pane

Optional environment

For Commands page actions that need an Anthropic key (e.g. author.regen, author.maintain), the sidecar auto-loads .env from ./, the attune-gui repo root, ~/.attune-gui/, or ~/.attune/. Common keys:

ANTHROPIC_API_KEY=sk-ant-…
ATTUNE_SPECS_ROOT=/path/to/your/repo/specs
ATTUNE_WORKSPACE=/path/to/your/project

License

Apache-2.0