Run Local Development¶

Start the development stack from the generated project directory with the installed CLI. Run agentseek doctor first when you expect startup to proceed without setup errors.

agentseek dev

Preview the startup plan without launching services.

agentseek dev --dry-run

output excerpt

Startup plan
  Gateway: uv run bub gateway --enable-channel ag-ui
  Frontend: npm run dev
  App: http://127.0.0.1:5173
  Gateway: http://127.0.0.1:8088/agent
  Copilotkit: http://127.0.0.1:4000/api/copilotkit

The startup plan comes from process and service declarations.

.agentseek/lifecycle.toml excerpt

[processes.gateway]
command = ["uv", "run", "bub", "gateway", "--enable-channel", "ag-ui"]

[processes.frontend]
command = ["npm", "run", "dev"]
cwd = "frontend"

[services.app]
url = "http://127.0.0.1:5173"

Skip the preliminary strict doctor pass when you already know the project state. Core required inputs declared by the lifecycle spec are still enforced before processes start.

agentseek dev --skip-check

Use Ctrl+C to stop the local development stack.

Run Local Development¶

Next¶