https://github.com/smart-ai-memory/attune-gui-plugin
Claude Code plugin that launches the attune-gui dashboard in the Cowork preview pane
https://github.com/smart-ai-memory/attune-gui-plugin
Last synced: about 2 months ago
JSON representation
Claude Code plugin that launches the attune-gui dashboard in the Cowork preview pane
- Host: GitHub
- URL: https://github.com/smart-ai-memory/attune-gui-plugin
- Owner: Smart-AI-Memory
- Created: 2026-05-03T02:33:35.000Z (about 2 months ago)
- Default Branch: master
- Last Pushed: 2026-05-03T03:11:09.000Z (about 2 months ago)
- Last Synced: 2026-05-03T04:27:08.097Z (about 2 months ago)
- Size: 3.91 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# attune-gui Plugin
A Claude Code plugin that launches the
[attune-gui](https://github.com/Smart-AI-Memory/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//` 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](https://docs.astral.sh/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`:
```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