Agent commands

Create, manage, and interact with AI agents

Agent commands let you create, configure, and interact with autonomous AI agents.

jazz agent create

Create a new agent interactively.

jazz agent create

Launches an interactive wizard that guides you through:

1. Agent type selection: Choose predefined agent types (coder, researcher) or custom
2. LLM provider: Select from 15+ supported providers
3. Model selection: Pick the right model for your use case
4. Tool selection: Choose which capabilities to enable
5. Name and description: Give your agent an identity

Use predefined agent types for quick setup with optimized tool sets and prompts.

jazz agent list

List all configured agents.

jazz agent list
jazz agent ls  # alias

Options:

-v, --verbose · boolean

Show additional details including tool lists

Displays a formatted table with:

• Agent name and description
• LLM provider and model
• Persona type
• Reasoning effort level
• Creation and update timestamps
• Agent ID

jazz agent show

View detailed information about a specific agent.

jazz agent show <agentId>

Arguments:

agentId · string · required

Agent ID or name to display

Shows complete agent configuration:

• Model and provider details
• Persona configuration
• Enabled tools
• Metadata (created, updated)
• Full agent ID

jazz agent edit

Edit an existing agent’s configuration.

jazz agent edit <agentId>

Arguments:

agentId · string · required

Agent ID or name to edit

Launches an interactive editor where you can modify:

• Name and description
• LLM provider and model
• Tool selection
• Persona
• Reasoning effort

Editing an agent’s configuration will affect all future conversations with that agent.

jazz agent delete

Delete an agent permanently.

jazz agent delete <agentId>
jazz agent remove <agentId>  # alias
jazz agent rm <agentId>      # alias

Arguments:

agentId · string · required

Agent ID or name to delete

This operation is irreversible. All agent configuration and metadata will be permanently deleted.

jazz agent chat

Start an interactive chat session with an agent.

jazz agent chat <agentIdentifier> [options]

Arguments:

agentIdentifier · string · required

Agent ID or name to chat with

Options:

--stream · boolean

Force streaming mode for real-time output

--no-stream · boolean

Disable streaming mode

During chat, you can use in-chat slash commands like /tools, /model, /help, etc.

Examples

Create a code review agent

jazz agent create
# Select: coder
# Provider: anthropic
# Model: claude-3-5-sonnet-20241022
# Tools: git, filesystem, shell
# Name: code-reviewer

List all agents with verbose output

jazz agent list --verbose

Chat with an agent by name

jazz agent chat code-reviewer

View agent details

jazz agent show code-reviewer

Delete an agent

jazz agent delete old-agent

Tips

Agent names are case-insensitive. You can use either the name or ID to reference an agent.

Create specialized agents for different tasks. For example, one for code review, one for research, one for email management.

Use reasoning models (like o1, o3-mini) for complex problem-solving tasks that require step-by-step thinking.

Next steps

In-chat commands

Learn about slash commands during chat

Creating agents

Detailed guide to agent creation