Create an agent with the Bolna CLI

Create a new agent. On a real terminal with no --file flag, this walks you through an interactive wizard; pass --file to create from a raw JSON config instead. Maps to the create_agent MCP tool.

Syntax

bolna agents create [flags]

Flags

Flag	Description	Default
`-h, --help`	Show help for the command	–
`--file string`	Path to a JSON file with a full `agent_config` + `agent_prompts` payload, matching the Create Agent API body	–
`-o, --output string`	Output format: `table` or `json`	`table`

--file is required in a non-interactive context (a script or CI pipe) — there’s no wizard to fall back to without a terminal.

Example

# Interactive wizard
bolna agents create

# Create from a JSON config file
bolna agents create --file config.json

config.json

{
  "agent_config": {
    "agent_name": "Front Desk Concierge",
    "agent_welcome_message": "Hi, thanks for calling Acme — how can I help?",
    "tasks": [
      {
        "tools_config": {
          "llm_agent": { "provider": "openai", "model": "gpt-4o-mini" },
          "synthesizer": { "provider": "sarvam", "voice": "Maya" }
        }
      }
    ]
  },
  "agent_prompts": {
    "task_1": { "system_prompt": "## Role\nYou are a front-desk concierge for Acme Corp..." }
  }
}

updateUse the bolna agents update command to change an agent's name, prompt, welcome message, or webhook, with a before/after diff and confirmation.

⌘I

Get Started

Agents

Calls

Resources

Account

Dashboard (TUI)

Create an agent with the Bolna CLI

Syntax

Flags

Example

​Syntax

​Flags

​Example

Syntax

Flags

Example