← All Skills
🗂️
Visual Brief Local Agent Reports
Publishes substantial implementation, investigation, review, or design results as self-contained local HTML briefings. One to six lanes progressively reveal claims, explanations, evidence, trust labels, and questions beside the relevant result.
Key Features
- Local progressive-disclosure HTML briefs
- Layered claims, explanations, and evidence
- Stable-ID ledger of earlier briefings
- Optional inline questions and reminders
Installation
Install the CLI with uv tool install visual-brief. For Codex, add the pchalasani/claude-code-tools marketplace and install visual-brief@cctools-codex-plugins; Claude Code uses the cctools-plugins variant. Review and trust the Codex hook definition before enabling it.
How to Use
Create a run with visual-brief new, start the loopback server with visual-brief serve, and publish JSON containing id, timestamp, headline, summary, and one to six lanes. Mark each item as verified-by-me, reported-by-agent, unverified, or known-limitation so evidence strength remains visible.
Requirements
The CLI and briefings stay local, the service is loopback-only, and no work is stored remotely; the default data root is ~/.claude/visual-brief/runs/. Version 0.1.0 is an initial public release whose interfaces may change. Plain Codex can publish but cannot receive live page questions; that optional path requires the codex-dynamic local callback bridge and explicit host-execution approval.
Related Skills