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

# Run a task

> Give the agent a repository and a task, then review the diff it opens.

A coding agent takes a repository and a plain-language task, edits the code on a branch, and leaves the diff for you to review.

This page is an example of how those docs can read. The steps are illustrative.

## What you do

**1. Open a repository**

Point the agent at the repo you want changed. It reads the project before it edits anything.

**2. Describe the task**

Say what should be true when the work is done. Name the file or the behavior when you know it.

**3. Let it work on a branch**

The agent edits code, runs the check it can run, and keeps the result on a branch. It does not merge.

**4. Review the diff**

Read the diff. Merge it when it matches the task. Discard it when it does not.

## Example prompt

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
The login form accepts a blank email. Reject an empty email before submit, and add a test for that case.
```

## What you should see

| Moment | What happens |
| - | - |
| Read | The agent opens the form component and the nearest test. |
| Edit | It adds a guard and a test that fails, then passes. |
| Review | A branch and a diff are waiting. Nothing ships until you merge it. |

> [!NOTE]
>
> This is a sample of the docs shape, not the finished product reference.

> [card] [Coding agents](https://docs.prisminference.com/guides/coding-agents.md)
>
> Point an existing harness at the inference API.


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