> ## Documentation Index
> Fetch the complete documentation index at: https://docs.castari.com/llms.txt
> Use this file to discover all available pages before exploring further.

# cast agents

> List and manage agents

# cast agents

Commands for listing and managing your agents.

## cast agents list

List all your agents.

### Usage

```bash theme={null}
cast agents list
```

### Output

```
NAME           SLUG           STATUS    CREATED
My Agent       my-agent       active    2024-01-15
Research Bot   research-bot   active    2024-01-14
Test Agent     test-agent     stopped   2024-01-10
```

***

## cast agents get

Get details for a specific agent.

### Usage

```bash theme={null}
cast agents get <slug>
```

### Example

```bash theme={null}
cast agents get my-agent
```

### Output

```
Name:        My Agent
Slug:        my-agent
Status:      active
Created:     2024-01-15 10:30:00
Updated:     2024-01-15 14:22:00
Sandbox ID:  sbx_xyz789
Git Repo:    https://github.com/user/my-agent
```

***

## cast agents create

Create a new agent without deploying.

### Usage

```bash theme={null}
cast agents create <name> <git-url> [options]
```

### Arguments

| Argument  | Description                | Required |
| --------- | -------------------------- | -------- |
| `name`    | Display name for the agent | Yes      |
| `git-url` | Git repository URL         | Yes      |

### Options

| Option          | Description                                            |
| --------------- | ------------------------------------------------------ |
| `--slug <slug>` | Custom slug (auto-generated from name if not provided) |

### Example

```bash theme={null}
cast agents create "My Agent" https://github.com/user/my-agent
```

With a custom slug:

```bash theme={null}
cast agents create "My Agent" https://github.com/user/my-agent --slug my-custom-slug
```

<Note>
  Most users should use `cast init` + `cast deploy` instead of `cast agents create`. This command is for advanced use cases.
</Note>

***

## cast agents delete

Delete an agent.

### Usage

```bash theme={null}
cast agents delete <slug>
```

### Example

```bash theme={null}
cast agents delete my-agent
```

### Output

```
? Are you sure you want to delete 'my-agent'? (y/N) y
✓ Agent 'my-agent' deleted
```

<Warning>
  This permanently deletes the agent, its secrets, and all invocation history. This cannot be undone.
</Warning>

### Options

| Option        | Description              |
| ------------- | ------------------------ |
| `-f, --force` | Skip confirmation prompt |

```bash theme={null}
cast agents delete my-agent --force
```

***

## See Also

* [cast deploy](/cli/deploy) — Deploy an agent
* [cast invoke](/cli/invoke) — Invoke an agent
* [cast secrets](/cli/secrets) — Manage secrets