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

# Work with Koharu Agent

> Ask the Agent to inspect pages, edit content, and run the pipeline.

Give the Agent a concrete goal within the open project. Name the pages, the change you want, and anything it should leave untouched.

## Write a scoped request

> [tab] Text review
>
> > Review pages 3–5. Correct obvious OCR errors and translate into natural English while preserving honorifics. Keep typography unchanged.

> [tab] Visual review
>
> > Check whether the text on page 8 overflows its bubble. Adjust only the size and line breaks.

Reading the project's layers is enough for many text edits. Ask for visual inspection when appearance matters.

## Available tools

| Tool | Does |
| - | - |
| `get_project` | Lists the pages in order |
| `get_page` | Reads a page's panels, balloons, and text blocks in reading order, with source and translation |
| `get_layer` | Reads one layer with everything inside it |
| `get_history` | Reads the undo steps |
| `edit` | Applies changes to layers and pages as one undo step |
| `run` | Starts a pipeline run on the project, some pages, some text blocks, or a painted area |
| `stop` | Stops every pipeline run |
| `history` | Follows what a run has done so far |
| `view_page` | Renders a page as the editor draws it |

> [!NOTE]
>
> The tools do not import or export files, manage provider credentials, or work outside the open
> project.

## Edits, cancellation, and history

Agent changes use the same edits as the editor, so they redraw the canvas as they happen and each is an undo step. Pipeline runs the Agent starts appear in the activity center like any other run.

One request runs at a time. **Cancel** stops the Agent, and an edit already being applied finishes whole. A pipeline run the Agent started keeps going; stop it from the activity center. The conversation continues across requests and ends when you change the Agent's model or close the project.

**1. Inspect the changed pages**

Review source text, translations, and the canvas.

**2. Check the layout**

Verify placement and typography at normal reading size.

**3. Keep or undo the change**

Use undo for unwanted changes, and export after your review.


## Related topics

- [Set up Koharu Agent](https://koharu.rs/agent/setup.md)
- [Troubleshooting](https://koharu.rs/reference/troubleshooting.md)
- [Koharu documentation](https://koharu.rs/index.md)
- [Install Koharu](https://koharu.rs/installation.md)
- [Contribute to Koharu](https://koharu.rs/development/contributing.md)


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