Check a Project¶
Run readiness checks from the generated project directory with the installed CLI.
Prepare .env and run agentseek task frontend first when you expect a
passing check.
agentseek doctor
output excerpt
ok lifecycle.toml: Lifecycle spec is present.
ok uv: uv is available.
ok node: node is available.
ok npm: npm is available.
ok frontend/package.json: frontend/package.json is present.
ok frontend/node_modules: frontend/node_modules is present.
ok .env: .env is present.
ok BUB_MODEL: BUB_MODEL is configured.
ok BUB_API_KEY: BUB_API_KEY or BUB_OPENAI_API_KEY is configured.
ok gateway cwd: . is present.
ok frontend cwd: frontend is present.
Those checks come from required tools, paths, and environment entries.
.agentseek/lifecycle.toml excerpt
[tools]
required = ["uv", "node", "npm"]
[paths]
required = ["frontend/package.json", "frontend/node_modules"]
[env.BUB_API_KEY]
required = true
aliases = ["BUB_OPENAI_API_KEY"]
Use strict mode in automation when warnings should also fail the check.
agentseek doctor --strict
Use live mode after starting the app. It checks whether local services are listening.
agentseek doctor --live
output excerpt
ok gateway: http://127.0.0.1:8088/agent/health is reachable.
ok copilotkit: http://127.0.0.1:4000/health is reachable.
ok frontend: http://127.0.0.1:5173 is reachable.
Live checks use the service health targets declared by the project.
.agentseek/lifecycle.toml excerpt
[checks.gateway]
type = "http"
target = "http://127.0.0.1:8088/agent/health"
timeout = 2
attempts = 3