AgentKit CLI

Unified CLI for the AgentKit ecosystem — manage all your AI agent services from one tool.

Quick Start

npx agentkit init

This creates an agentkit.config.yaml in your project, sets up docker-compose.yaml, and scaffolds your workspace.

Commands

agentkit init

Interactive project setup. Asks for project name, language (TypeScript/Python), and which services to enable.

$ agentkit init
? Project name: my-agent
? Language: typescript
? Enable AgentLens? yes
? Enable Lore? yes
...
✅ Project initialized!

agentkit status

Show the status of all configured services.

$ agentkit status
Service        | Status     | Port  | Version
---------------|------------|-------|--------
agentlens      | ✅ running | 3000  | 1.2.0
lore           | ❌ down    | 3001  | -
agenteval      | ⚪ disabled | -     | -

Options:

• -c, --config <path> — Config file path (auto-detected if omitted)
• -t, --timeout <ms> — Connection timeout (default: 3000)

agentkit doctor

Run diagnostic checks on your setup.

$ agentkit doctor
✅ Config file
✅ Docker daemon
✅ agentlens container
❌ lore health → Check logs with `docker compose logs lore`

Options:

• -c, --config <path> — Config file path (auto-detected if omitted)
• -t, --timeout <ms> — Connection timeout (default: 3000)

Configuration

The agentkit.config.yaml file:

projectName: my-agent
language: typescript
services:
  agentlens:
    enabled: true
    port: 3000
  lore:
    enabled: true
    port: 3001
  agentgate:
    enabled: false
  formbridge:
    enabled: false
  agenteval:
    enabled: false

Schema

Field	Type	Description
projectName	string	Project name (required)
language	"typescript" | "python"	Project language
services.<name>.enabled	boolean	Whether the service is active
services.<name>.port	number	Override default port
services.<name>.version	string	Pin a specific version

Supported Services

Service	Default Port	Description
AgentLens	3000	Observability and monitoring for AI agents
Lore	3001	Knowledge management and RAG pipeline
AgentGate	3002	API gateway and rate limiting
FormBridge	3003	Form generation and data collection
AgentEval	—	Evaluation and benchmarking (CLI-only)

Config Auto-Discovery

When you run status or doctor without --config, the CLI walks up the directory tree (up to 10 levels) looking for agentkit.config.yaml. If none is found, it prints:

No agentkit.config.yaml found. Run `agentkit init` to get started.

🧰 AgentKit Ecosystem

Project	Description
AgentLens	Observability & audit trail for AI agents
Lore	Cross-agent memory and lesson sharing
AgentGate	Human-in-the-loop approval gateway
FormBridge	Agent-human mixed-mode forms
AgentEval	Testing & evaluation framework
agentkit-mesh	Agent discovery & delegation
agentkit-cli	Unified CLI orchestrator	⬅️ you are here
agentkit-guardrails	Reactive policy guardrails

License

ISC