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

# memanto agent create

> Create a new agent and activate it immediately.

# memanto agent create

Create a new agent and activate it immediately.

```bash theme={null}
memanto agent create AGENT_ID [OPTIONS]
```

**Arguments:**

* `AGENT_ID` - Unique agent identifier (required, alphanumeric / hyphens / underscores)

**Options:**

* `--pattern TEXT` - Agent pattern: `project`, `support`, or `tool` (default: `tool`)
* `--description TEXT` - Optional agent description

**Examples:**

Simple creation (defaults to `tool` pattern):

```bash theme={null}
memanto agent create customer-support
```

Specify a pattern:

```bash theme={null}
memanto agent create customer-support --pattern support
```

With description:

```bash theme={null}
memanto agent create customer-support \
  --pattern support \
  --description "Handles customer inquiries"
```

**Output:**

```
Agent 'customer-support' created successfully!
Pattern: support
Description: Handles customer inquiries
Agent activated automatically.
Activation expires: 2026-05-10T22:30:00Z
You can now run: memanto remember "..." and memanto recall "..."
```

**Notes:**

* Agent IDs must be unique and use alphanumeric, hyphens, or underscores only — no spaces
* Creating an agent automatically activates a 6-hour session