buoy show
Read-only views of your design system. Shows what's configured,
what's drifting, and what still needs setup. If something isn't configured,
show tells you which dock command to run.
Usage
Commands
components List detected components and their token usage tokens Show resolved design tokens drift Show current drift signals with severity and type filters health Show design system health score and audit history Show scan history and compare scans config Show current .buoy.yaml configuration skills Show AI agent skill files agents Show configured AI agents and commands context Show design system context in CLAUDE.md hooks Show configured hooks for drift checking commands Show installed slash commands graph Show knowledge graph statistics plugins Show available scanners and plugins all Show everything including setup status Global Options
--json Output as JSON for scripting --no-cache Bypass cache and re-scan the codebase buoy show components
List components found in your codebase with optional search. Supports fuzzy name search, prop search, and pattern matching.
[query] Search by component name (fuzzy match) --prop <name> Search by prop name --pattern <pattern> Search by pattern (name, props, variants) -n, --limit <number> Maximum results (default: 10) buoy show tokens
Show resolved design tokens from your codebase.
buoy show drift
Show current drift signals. Supports severity filters, type filters, and multiple output formats (tree, table, markdown, HTML, agent).
--raw Raw signals without grouping -f, --format <type> Output format: json, markdown, html, table, tree, agent -S, --severity <level> Filter by minimum severity (info, warning, critical) -t, --type <type> Filter by drift type -v, --verbose Verbose output with full details --include-ignored Include ignored drifts buoy show health
Generate a health report for your design system. Shows unique values found, compares against expected counts, identifies worst offender files, and calculates a 0-100 score.
--tokens <path> Path to design tokens file for typo detection Score Ranges
80-100 Good — Design system is well adopted 50-79 Fair — Some drift, worth addressing 30-49 Needs Work — Significant drift detected 0-29 Poor — Major drift, prioritize fixes buoy show history
View scan history and track design system health over time. Compare scans to see progress and regressions.
[scan-id] Show details of a specific scan -n, --limit <number> Number of scans to show (default: 10) -v, --verbose Show detailed information Subcommands
compare <scan1> <scan2> Compare two scans buoy show config
Show the current .buoy.yaml configuration — project name, enabled sources,
patterns, and output settings.
If no config exists:
buoy show skills
Show AI agent skill files installed in .claude/skills/design-system/.
If no skills exist:
buoy show agents
Show configured AI agents and slash commands in .claude/agents/
and .claude/commands/.
If no agents exist:
buoy show context
Show the design system section from CLAUDE.md. Displays line count,
word count, and a preview.
If no context exists:
buoy show hooks
Show configured hooks — both git pre-commit hooks and Claude Code hooks.
If no hooks exist:
buoy show commands
Show installed Buoy slash commands in ~/.claude/commands/.
If no commands exist:
buoy show graph
Show knowledge graph statistics — node and edge counts by type.
If no graph exists:
buoy show plugins
Show built-in scanners, detected frameworks, and optional plugins. This always shows data — plugins are built-in and don't require setup.
buoy show all
Show everything — components, tokens, drift, health, and setup status.
Outputs JSON with a setup section showing which tools are configured.
<div class="">{</div><div class=""> "components": [...],</div><div class=""> "tokens": [...],</div><div class=""> "drift": { "groups": [...], "summary": { ... } },</div><div class=""> "health": { "score": 72, "categories": { ... } },</div><div class=""> "setup": {</div><div class=""> "config": true,</div><div class=""> "skills": true,</div><div class=""> "agents": true,</div><div class=""> "context": true,</div><div class=""> "hooks": { "git": true, "claude": true },</div><div class=""> "commands": true,</div><div class=""> "graph": false</div><div class=""> }</div><div class="">}</div>Related
- buoy drift — Scan, check, fix, and manage ignore rules
- buoy dock — Setup tokens, graph, and project config
- buoy dock — Set up everything that
showdisplays