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

# Shortcuts

> Aliases and shorthand for common CLI commands.

The CLI ships with single-letter aliases for the verbs you use most. Aliases compose: `xpander` → `x`, `agent` → `a`, then a single letter for the action.

```bash theme={"dark"}
# Full
xpander agent new

# Short
x a n
```

## Authentication

| Shortcut | Full command |
| - | - |
| `x l` | `xpander login` |
| `x c` | `xpander configure` |

## Top-level lifecycle (apply to active agent or to `[agent]`)

These exist as both top-level shortcuts and `agent` subcommands. The forms are equivalent: the top-level form is shorter.

| Shortcut | Full | Equivalent |
| - | - | - |
| `x i [agent]` | `xpander initialize` | `xpander agent init` (`agent i`) |
| `xpander dev [agent]` | – | `xpander agent dev` |
| `xpander invoke [agent] "msg"` | – | `xpander agent invoke` |

## Agent namespace

| Shortcut | Full command |
| - | - |
| `x a` | `xpander agent` |
| `x a n` | `xpander agent new` |
| `x a g <agent>` | `xpander agent get` |
| `x a i [agent]` | `xpander agent init` |
| `x a o [agent]` | `xpander agent edit` (or `agent open`) |
| `x a del [agent]` | `xpander agent delete` |
| `x a invoke [agent] "msg"` | `xpander agent invoke` |

## Common chains

```bash theme={"dark"}
x a n                       # create new agent (interactive)
x a i                       # scaffold its files locally
xpander dev                 # run it locally
```

When `[agent]` is omitted, the CLI shows an interactive selection list: handy when you only have one or two agents in a profile, or use `--no-interactive` to fail instead of prompting.

## Global flags (work with every shortcut)

| Flag | Description |
| - | - |
| `-v, --version` | Print version. |
| `--profile <n>` | Use a specific profile. |
| `--api-key <key>` | Override API key for this command. |
| `--output <fmt>` | `json` or `table`. |
| `-y, --yes` | Auto-approve prompts. |
| `--no-interactive` | Disable interactive prompts (fail if input is needed). |
| `-h, --help` | Show help for the current command. |

These compose with shortcuts:

```bash theme={"dark"}
x a list --json --profile staging
x a d --confirm --no-interactive
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.