How svtoo/atk-registry works
ATK Registry is a curated catalog of plugins that users install by name through ATK. The README establishes that registry workflow, but the supplied tree does not include its index or plugin manifests, so the installation internals cannot be mapped reliably. Sampled runtime code shows several distinct plugin capabilities: Claude chat dashboards, Hindsight memory and bank management, and Piper text-to-speech. The dashboard flow is supported by the sampled hook, server, and regeneration code; other unsampled subsystem wiring is left out.
Main entry points: regen.py Dashboard regen · app.py Hindsight CLI · server.py Speak tool · client.py Hindsight API
Components 19
Chat dashboards
- Stop hook
plugins/claude-dashboard/hooks/dashboard-update-hook.py - Preview hook
plugins/claude-dashboard/preview/session_open.py - Dashboard server
plugins/claude-dashboard/server/serve.py - Dashboard regen
plugins/claude-dashboard/server/regen.py - Dashboard store
plugins/claude-dashboard/server/store.py
Hindsight memory
- Hindsight CLI
plugins/hindsight/src/hindsight_cli/app.py - Bank commands
plugins/hindsight/src/hindsight_cli/banks.py - Mental models
plugins/hindsight/src/hindsight_cli/mental_models.py - Hindsight API
plugins/hindsight/src/hindsight_cli/client.py - Bank configuration
plugins/hindsight/src/conform.py
Piper speech
- Speak tool
plugins/piper/server.py - Piper TTS service
Other components
- ATK user
- ATK CLI
- Claude Code
- Browser pane
- Chat transcript
- MCP client
- System speakers
Connections 16
- ATK user → ATK CLI: installs plugins
- Claude Code → Stop hook: fires Stop hook
- Stop hook → Dashboard server: requests regeneration
- Dashboard server → Dashboard regen: dispatches job
- Dashboard regen → Chat transcript: reads events
- Dashboard regen → Dashboard store: records state
- Preview hook → Browser pane: prompts to open
- ATK user → Hindsight CLI: runs commands
- Hindsight CLI → Bank commands: dispatches bank commands
- Hindsight CLI → Mental models: dispatches model commands
- Bank commands → Hindsight API: calls API
- Mental models → Hindsight API: calls API
- Bank configuration → Hindsight API: configures banks
- MCP client → Speak tool: invokes speak
- Speak tool → Piper TTS service: sends text
- Speak tool → System speakers: plays audio