Skip to main content

Create a new Agent

Overview​

This guide explains how to create your first Agent with Warden Code—a CLI for developing Agents compatible with Warden.

You'll install and run Warden Code, provide the required details, and the Agent will be immediately available for local testing.

Prerequisites​

Before you start, complete the following prerequisites:

1. Install Warden Code​

Install Warden Code globally:

npm install -g warden-code

Alternatively, you can run it directly:

npx warden-code

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

tip

If you need to update the installed version, run this:

npm update -g warden-code

2. Run Warden Code​

Create a directory for your new project, navigate there, and run Warden Code:

warden

You'll see the list of available commands.

3. Create an Agent​

To create an Agent, take the following steps:

  1. Initiate Agent creation:

    /new

    Now the CLI will prompt you to provide the required details.

  2. Provide the Agent name and description.

  3. Select a template:

    • Blank: A minimal A2A server with no AI model. It just echoes the input back, which is good for testing. Later, you can specify the preferred LLM in the Agent code.
    • OpenAI: An AI-powered agent using OpenAI to reason and respond to tasks. You'll be prompted to provide your OpenAI API key from Prerequisites.

  4. Select the communication style:

    • Streaming: Tokens stream in real-time as the model generates, leading to a faster perceived response.
    • Mulit-turn converstions: Responses arrive all at once after completion, which is simpler to work with.

  5. Optionally, provide skills describing what your Agent can do. This does not affect the real capabilities of the Agent—you'll need to implement custom logic later.

    note

    You Agent's skills are advertised in the A2A Agent Card. This allows them to be discovered by other Agents and clients.

  6. Optionally, enable x402 payments. You'll need to select a network and provide your wallet address for receiving payments. To learn more, see Configure x402 payments.

  7. Confirm Agent creation.

    tip

    You can reconfigure your Agent later by running the /config command. For example, you can update the Agent Card or set optional parameters if you skipped them.

Result​

Depending on your choices, Warden Code generates a new project based one of the supported Agent models.

This project structure includes the following key files:

  • src/agent.ts: Your Agent's logic
  • .env: Your API key for authentication, the LLM key (if provided), and more
warning

Never expose your API keys on GitHub. Before publishing your project, you must keep the API key in a safe space and delete it from the .env file.

Next steps​

Now you can do the following:

important

If you get stuck or have any questions, join the developer channel in our Discord: #developers.