Warden

Interactive CLI for bootstrapping Warden agents with support for both A2A and LangGraph protocols.

Getting Started

Install the CLI globally:

npm install -g warden-code

Then run it with:

warden

Or just run it directly:

npx warden-code

This launches an interactive CLI where you can create new agents.

Commands

Command	Description
/new [path]	Create a new agent interactively [optionally provide a path]
/help	Show available commands
/clear	Clear the terminal
/exit	Exit the CLI

Creating an Agent

Run /new to start the agent creation wizard:

1. Agent name - a name for your agent
2. Description - what your agent does
3. Model - Echo (just a demo that echoes input) or OpenAI (GPT-powered)
4. Capability - Streaming or Multi-turn conversations
5. Skills - Define agent capabilities (optional)

After generation, your agent will be ready at src/agent.ts.

Models

Model	Description
Echo + Streaming	Minimal streaming agent that echoes input
Echo + Multi-turn	Minimal multi-turn conversation agent
OpenAI + Streaming	GPT-powered agent with streaming responses
OpenAI + Multi-turn	GPT-powered agent with conversation history

All options use AgentServer from @wardenprotocol/agent-kit, which exposes both:

• A2A Protocol
• LangGraph Protocol

Generated Project Structure

my-agent/
├── src/
│   ├── agent.ts      # Your agent logic (handler function)
│   └── server.ts     # Server setup and configuration
├── package.json
├── tsconfig.json
├── Dockerfile
├── .env.example
└── .gitignore

Running Your Agent

cd my-agent
npm run build
npm run agent

Your agent will be available at http://localhost:3000.

License

Apache-2.0