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

> ## Agent Instructions
> To set Ambral up in a project, run `npx ambral@latest skill install` in the project's root. It installs Ambral's skill, matched to the CLI's version, and the skill says how to do everything these pages describe with the `ambral` CLI. Prefer it to working from these pages. Never ask anyone for an Ambral API key, and never handle one: the person creates it in the web app and stores it where their app reads its secrets.

# ambral prompts

> Put and read the system prompts to score models under, each by its pr_… id

Put and read the system prompts to score models under, each by its pr\_… id

Every ambral command also takes the [global flags](https://docs.ambral.ai/cli/reference/global-flags.md).

## ambral prompts put

```text theme={null}
ambral prompts put [flags] <file>
```

Put a prompt and print its id, derived from its exact text: the same text always has the same id, and any edit, whitespace included, makes another. `ambral runs start --subjects <model>@<id>` asks a model under it: it replaces the system prompt each trace opens with, or is added in front of one with none

| Argument | Takes | Description |
| - | - | - |
| `<file>` | string | The prompt: a text file, all of it the system prompt but the newline that ends it |

**Examples**

```sh theme={null}
# Put the file's prompt, printing its pr_… id
ambral prompts put prompts/shorter.txt
```

## ambral prompts get

```text theme={null}
ambral prompts get [flags] <prompt>
```

Print a prompt's text, exactly as it was put or as a taskset's traces sent it, as a text file holds it: `ambral prompts put` reads that file back under the same id. With `--json`, its id and exact text

| Argument | Takes | Description |
| - | - | - |
| `<prompt>` | string | The prompt's id, `pr_` and 16 hex digits, as `ambral prompts put` or `ambral tasksets prompts list` prints it |

**Examples**

```sh theme={null}
# Write the prompt to a file, to edit and put back
ambral prompts get pr_9d2e7a1c04b3f8e2 > prompts/shorter.txt
```


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