@evolutese/cli

Official CLI for the Evolutese platform. Scaffold projects, create agents interactively, run the dev server, validate definitions, and diagnose your environment.

Installation

npm install -g @evolutese/cli

Commands

evolutese init

Scaffold a full-stack project with a backend and a React frontend:

evolutese init

✔ Choose mode: App (BE + FE, recommended)
✔ App name: my-app
✔ LLM provider: Google (Gemini)
✔ Model: gemini-2.5-flash

✔ Created backend/ (Express + SDK + 7 blueprints)
✔ Created frontend/ (Vite + React)
✔ Written to backend/.env

Next steps:
  cd my-app/backend && npm install && npm run dev
  cd my-app/frontend && npm install && npm run dev

Generates:

• backend/ — Express server with @evolutese/sdk, 7 agent blueprints, and MongoDB connector wired up
• frontend/ — Vite + React app with @evolutese/react and the full three-panel layout
• .env — API key placeholders (fill in your LLM provider key)

evolutese agent new

Interactively create a new agent YAML file:

evolutese agent new

✔ Agent ID: invoice
✔ Agent name: Invoice Agent
✔ Description: Manages invoices
✔ Intent name: draft_invoice
✔ Intent type: workflow
✔ Add a step? yes
  ✔ Step ID: save
  ✔ Action: mongo
✔ Add another step? no
✔ Add another intent? no

✔ Written to backend/agents/invoice/agent.yml
✔ Updated backend/agents/registry.json

The generated file is validated against the Evolutese agent schema before being written. Run evolutese validate at any time to re-check.

evolutese validate

Validate agent YAML files against the schema:

# Validate a single file
evolutese validate agents/invoice/agent.yml

# Validate all agents in the project
evolutese validate

✓ agents/invoice/agent.yml — valid
✓ agents/tasks/agent.yml — valid

Useful in CI before deploy.

evolutese dev

Start the development runtime with hot reload:

evolutese dev

evolutese doctor

Check that your environment is correctly configured — env vars, dependencies, and agent catalog:

evolutese doctor

License

MIT