A
Docs
Back to Builder

Preview & Generate

Step 7: Review your configuration and download your agent project.

The final step lets you review your complete configuration, preview the generated code, and download your agent as a ZIP file.

Configuration Review

Before generating, verify your configuration:

Basic Settings

  • Domain - Your agent's area of expertise
  • Template - The template you selected (if any)
  • SDK Provider - Claude or OpenAI
  • Model - The specific model to use

Tools & MCP

  • Enabled tools - List of tools your agent can use
  • Permission level - Restrictive, Balanced, or Permissive
  • MCP servers - External servers configured

Project Metadata

  • Agent name - Display name
  • Project name - Directory name
  • Package name - npm package name
  • Version - Semantic version
  • License - License type

Code Preview

The preview panel shows the generated code for key files:

  • package.json - Dependencies and scripts
  • src/agent.ts - Main agent logic
  • src/cli.ts - CLI entry point
  • .mcp.json - MCP server configuration

Use the file tabs to switch between previews and verify the generated code matches your expectations.

Downloading Your Project

Click Download Project to generate a ZIP file containing your complete agent project.

ZIP Contents

1my-agent.zip
2├── package.json
3├── tsconfig.json
4├── src/
5│   ├── cli.ts
6│   ├── agent.ts
7│   ├── config.ts
8│   ├── permissions.ts
9│   ├── mcp-config.ts
10│   ├── planner.ts
11│   └── workflows.ts
12├── .commands/
13│   └── *.json           # Domain-specific workflow commands
14├── .plans/
15│   └── .gitkeep
16├── .mcp.json
17├── .env.example
18├── .gitignore
19├── README.md
20├── LICENSE
21└── scripts/
22    └── publish.sh

Next Steps After Download

1. Extract the ZIP

1unzip my-agent.zip
2cd my-agent

2. Install Dependencies

1npm install

3. Configure Environment

1cp .env.example .env
2# Edit .env and add your API key:
3# ANTHROPIC_API_KEY=your-key-here
4# or
5# OPENAI_API_KEY=your-key-here

4. Build the Agent

1npm run build

5. Run the Agent

1npm start

You're ready!

Your agent is now running. Type a message to start chatting, or use/help to see available commands.

Troubleshooting

Build Errors

If you encounter TypeScript errors during build:

  • Ensure you're using Node.js 18 or later
  • Delete node_modules and run npm install again
  • Check that all dependencies installed correctly

API Key Issues

If the agent can't connect to the AI provider:

  • Verify your API key is correct in .env
  • Check that the key has the required permissions
  • Ensure you're using the correct key for your selected provider

MCP Server Errors

If MCP servers fail to start:

  • Verify the required packages are installed globally or will be fetched via npx
  • Check that environment variables referenced in .mcp.json are set
  • Review server-specific documentation for setup requirements

Further Reading