CLI Reference
Installation And Invocation
| Command |
Description |
uv tool install agentseek |
Install the CLI for daily use. |
agentseek ... |
Run lifecycle commands after installation. |
uvx agentseek ... |
Run one AgentSeek command without installing the tool. |
Root Options
| Option |
Description |
--mode [cli\|agent] |
Select the CLI profile. The documented lifecycle workflow uses cli. |
--help |
Show help for the selected profile. |
Default Commands
| Command |
Description |
agentseek create [spec] |
Create a project from a template. |
agentseek doctor |
Check local readiness through the lifecycle spec. |
agentseek dev |
Start local development through the lifecycle spec. |
agentseek info |
Show project metadata and entry points. |
agentseek task |
Run project-defined lifecycle spec tasks. |
agentseek version |
Show AgentSeek version information. |
create
| Form |
Description |
agentseek create |
Select the type and template interactively. |
agentseek create <type> |
Use the default template for the type. |
agentseek create <type>/<name> |
Use a specific template. |
agentseek create <url-or-absolute-path> |
Pass the spec directly to Cookiecutter. |
The built-in template type set is currently bub, deepagents, and
langchain.
Options
| Option |
Description |
spec |
Template type, type/name, Git URL, or absolute local path. |
--list-templates |
List templates. With a type, list only that type. |
--template name |
Select a template under the chosen type, for example bub --template default. |
--template |
Compatibility entry point that lists templates. Prefer --list-templates in new scripts. |
--checkout ref |
Use a branch, tag, or commit when fetching the remote template source. |
--no-input |
Skip Cookiecutter variable prompts and use template defaults. |
Missing Templates
| Form |
Behavior |
agentseek create bub --template missing |
Exits with code 2 and shows the missing template plus supported bub templates. |
agentseek create bub/missing |
Exits with code 2 and shows the missing template plus supported bub templates. |
doctor
| Option |
Description |
--live |
Check already-running local services. |
--strict |
Treat warnings as failures. |
dev
| Option |
Description |
--dry-run |
Print the startup plan without launching services. |
--skip-check |
Skip the preliminary strict doctor pass before startup. Core required inputs are still enforced. |
info
| Option |
Description |
--verbose |
Show lifecycle loader discovery details. |
task
| Form |
Description |
agentseek task --list |
List project-defined lifecycle spec tasks. |
agentseek task --help |
Show the AgentSeek task boundary. |
agentseek task <name> |
Run a project-defined lifecycle spec task. |
task must run from a project directory containing .agentseek/lifecycle.toml.