How ob-labs/agentseek works
AgentSeek is a local, template-first lifecycle CLI for creating editable agent applications, then inspecting, configuring, checking, running, observing, and iterating on them. Its primary path starts with template discovery and creation; the generated project owns its runtime and integrations, while AgentSeek provides a stable lifecycle interface. The README documents the locked template catalog and lifecycle stages. Source excerpts are limited, so some CLI-to-subsystem links are documented rather than verified from implementation; the graph does not map template internals or unsampled integrations.
Main entry points: create.py Create project · info.py Inspect project · doctor.py Observe lifecycle · {{cookiecutter.project_slug}} Edit and iterate
Components 16
Lifecycle CLI
- Discover templates
src/agentseek/cli/commands/create.py - Create project
src/agentseek/cli/commands/create.py - Inspect project
src/agentseek/cli/commands/info.py - Check readiness
src/agentseek/cli/commands/doctor.py - Run development stack
src/agentseek/cli/commands/dev.py - Observe lifecycle
src/agentseek/cli/commands/doctor.py - Setup tasks
src/agentseek/cli/commands/task.py - Machine JSON contract
src/agentseek/cli/lifecycle/json_output.py
Template Catalog
- Locked template catalog
- Template sources
templates
Generated Project
- Configure project
templates/deepagents/research/{{cookiecutter.project_slug}} - Edit and iterate
templates/deepagents/research/{{cookiecutter.project_slug}} - Editable application
templates/deepagents/research/{{cookiecutter.project_slug}} - Lifecycle contract
src/agentseek/cli/lifecycle/authored.py
CLI Internals
- Lifecycle safety
src/agentseek/cli/lifecycle/safety.py
Other components
- Developer
Connections 17
- Developer → Discover templates: selects goal
README.md - Discover templates → Locked template catalog: lists templates
README.md - Developer → Create project: requests scaffold
README.md - Create project → Locked template catalog: fetches locked content
README.md - Locked template catalog → Template sources: provides templates
README.md - Create project → Editable application: renders project
README.md - Developer → Inspect project: inspects entry points
README.md - Inspect project → Lifecycle contract: reads declarations
README.md - Developer → Configure project: sets credentials
README.md - Developer → Setup tasks: runs setup tasks
README.md - Developer → Check readiness: checks readiness
README.md - Developer → Run development stack: starts local stack
README.md - Developer → Observe lifecycle: checks live state
README.md - Observe lifecycle → Machine JSON contract: emits machine output
README.md - Developer → Edit and iterate: edits project
README.md - Edit and iterate → Inspect project: returns to inspection
README.md - Lifecycle contract → Lifecycle safety: uses safety checks
src/agentseek/cli/lifecycle/authored.py