Agent Commands

The agent commands allow you to create, list, delete, and manage agents in your Agentuity project.

agent create

Creates a new agent in your project.

Aliases: new

Usage

agentuity agent create [name] [description] [auth_type]

Arguments:

• name - The name of the agent
• description - A description of what the agent does
• auth_type - Authentication method for the agent (API Key or None)

Flags:

• -d, --dir string - The project directory

This command will prompt you for:

• The name of the agent
• A description of what the agent does
• Authentication type (API Key or None)

After providing this information, the command will:

1. Create the agent in the Agentuity Cloud
2. Set up the necessary local files for the agent
3. Update your project configuration to include the new agent

Example

agentuity agent create

agent list

Lists all agents in your project.

Aliases: ls

Usage

agentuity agent list

Flags:

• -d, --dir string - The project directory

This command will display a list of all agents in your project, including:

• Agent name
• Agent ID
• Agent description
• Status (whether the agent exists locally, remotely, or both)

Example

agentuity agent list

agent delete

Deletes one or more agents from your project.

Aliases: rm, del

Usage

agentuity agent delete

Flags:

• -d, --dir string - The project directory

This command will:

1. Display a list of all agents in your project
2. Allow you to select one or more agents to delete
3. Ask for confirmation before deleting the selected agents
4. Delete the selected agents from both the Agentuity Cloud and your local project

Example

agentuity agent delete

agent apikey

Gets the API key for an agent.

Aliases: key

Usage

agentuity agent apikey [agent_name]

Arguments:

• agent_name - The name or ID of the agent (optional)

Flags:

• -d, --dir string - The project directory

This command will:

1. If an agent name is provided, retrieve the API key for that agent
2. If no agent name is provided and there's only one agent in the project, retrieve the API key for that agent
3. If no agent name is provided and there are multiple agents, display a list of agents to select from

Example

Get an API key for a specific agent:

agentuity agent apikey MyFirstAgent

Get an API key for an agent interactively:

agentuity agent apikey

Global Flags

These flags apply to all agent commands:

• --config string - Config file (default is $HOME/.config/agentuity/config.yaml)
• --log-level string - The log level to use (default "info")