# Prompt

URL: https://docs.hanzo.ai/docs/cli/prompt

> The `hanzo prompt` commands.

Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/prompt) · **CLI** · [MCP](https://docs.hanzo.ai/docs/mcp-tools/prompt) · [SDKs](https://docs.hanzo.ai/docs/sdks)

Your prompt library, versioned, so nothing changes silently.

[API reference →](https://docs.hanzo.ai/docs/openapi/prompt)

```bash
hanzo prompt list
```

Every command takes `--json` for the raw response and `--help` for its own flags. Sign in once with `hanzo auth login`; the commands below use that session, and the org they act in is the one it carries.

| Command                   | What it does                                                                                                                                                                 |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo prompt catalog`    | Returns the read-only starter prompt library shipped with the binary — reference content every tenant sees the same, NOT the caller's own prompts and never mixed into them. |
| `hanzo prompt create`     | Records a prompt for the caller's org and answers 201 with it.                                                                                                               |
| `hanzo prompt get <name>` | Returns one of the caller org's prompts: its CURRENT template text plus the metadata of every version it has had.                                                            |
| `hanzo prompt list`       | Returns the caller org's prompt library as one row per prompt: its name, type, every version number it has, its taxonomy and when it last changed.                           |
| `hanzo prompt metrics`    | Returns real per-prompt statistics for the caller's org: how many versions each prompt has, which one is current, and when it was created and last changed.                  |
| `hanzo prompt rm <name>`  | Removes one of the caller org's prompts and every version of it, answering 204.                                                                                              |