How svtoo/atk works
ATK is a CLI plugin manager for discovering, installing, configuring, and operating AI-development tools, then connecting their MCP servers and skills to coding agents. The main workflow is search or choose a plugin, add it to git-backed ATK Home, configure its environment, and plug it into selected agents; lifecycle commands then start, inspect, upgrade, or remove it. The graph includes documented capabilities whose command implementations were not sampled; links to those modules are intentionally limited to documented CLI dispatch. The MCP/agent wiring is supported by sampled source.
Main entry points: cli.py ATK CLI · add.py Plugin add · manifest_schema.py Manifest · lifecycle.py Lifecycle runner
Components 22
CLI Interface
- ATK CLI
src/atk/cli.py - Registry search
src/atk/commands/search.py
Plugin Operations
- Plugin add
src/atk/add.py - Environment setup
src/atk/setup.py - Lifecycle commands
src/atk/commands/lifecycle.py - Lifecycle runner
src/atk/lifecycle.py - Status reporting
src/atk/commands/status.py - Plugin upgrade
src/atk/upgrade.py - Plugin removal
src/atk/remove.py
Home and Registry
- Manifest
src/atk/manifest_schema.py - ATK Home
src/atk/home.py - Git operations
src/atk/git.py - Registry access
src/atk/registry.py - Plugin definitions
src/atk/plugin_schema.py
Agent Integration
- Plug orchestration
src/atk/commands/plug.py - MCP configuration
src/atk/mcp.py - Agent adapters
src/atk/commands/mcp.py - Skill adapters
src/atk/agents
Other components
- Developer
- Coding agents
- Plugin services
- ATK registry
Connections 36
- Developer → ATK CLI: runs commands
- ATK CLI → Registry search: dispatches search
- ATK CLI → Plugin add: dispatches add
- ATK CLI → Environment setup: dispatches setup
- ATK CLI → Lifecycle commands: dispatches lifecycle
- ATK CLI → Status reporting: dispatches status
- ATK CLI → Plugin upgrade: dispatches upgrade
- ATK CLI → Plugin removal: dispatches remove
- ATK CLI → Plug orchestration: dispatches plug
- Registry search → Registry access: fetches index
- Registry search → Manifest: reads installed set
- Registry access → ATK registry: fetches registry
- Plugin add → Registry access: fetches plugin
- Plugin add → Plugin definitions: loads definition
- Plugin add → Manifest: records plugin
- Plugin add → ATK Home: installs into
- Plugin add → Git operations: fetches source
- Environment setup → Plugin definitions: reads requirements
- Environment setup → ATK Home: configures plugin
- Lifecycle commands → Lifecycle runner: runs commands
- Lifecycle runner → Manifest: reads plugins
- Lifecycle runner → Plugin definitions: loads lifecycle
- Lifecycle runner → Plugin services: runs lifecycle
- Status reporting → Manifest: reads plugins
- Status reporting → Plugin services: checks state
- Plugin upgrade → Manifest: reads sources
- Plugin upgrade → Git operations: fetches updates
- Plugin removal → Lifecycle runner: runs uninstall
- Plugin removal → Manifest: updates manifest
- Plug orchestration → MCP configuration: resolves config
- Plug orchestration → Agent adapters: registers MCP
- Plug orchestration → Skill adapters: injects skills
- Agent adapters → Coding agents: configures agents
- Skill adapters → Coding agents: writes skill context
- MCP configuration → Plugin definitions: reads MCP definition
- MCP configuration → ATK Home: resolves plugin files