# Muse or an outside agent?

Source: https://docs.novelos.studio/write-with-ai/muse-or-agent/ (updated 2026-11-09). Part of the NovelOS Studio 1.5.1 docs.

**Before you start:** [Review and undo AI changes](https://docs.novelos.studio/write-with-ai/review-and-undo.md)

NovelOS has two ways to bring AI into a book, and they aren't rivals. [Muse](https://docs.novelos.studio/guides/muse.md) is built in: buttons in the app that make one thing well, right where you are. An outside agent such as Claude Code works through the MCP server: a conversation that can read across the whole book and come back with a report.

## How they differ

| | Muse | Outside agent |
| --- | --- | --- |
| Where | Inside NovelOS, on the page you're on | A separate app or terminal, talking to NovelOS |
| You ask by | Clicking a button, sometimes with a short note | Typing what you want in your own words |
| Sees | The parts of your book that its prompt needs | Anything in the books you share, as it asks for it |
| Good at | Making things: rewrites, concepts, outlines, pictures | Reading a lot and reporting: checks, summaries, plans |
| Pays for it | Your own Gemini or OpenAI key | Your AI tool's own account |
| Shape it with | Its prompts, in **Settings › Muse (AI) › Prompts** | The Skills, and what you type |
| Changes | Land where you used it, like your own edits | Logged in **Activity**, where each one can be undone |

Both are part of the full version.

## Use Muse when

- You want three rewrites of a sentence you've selected, now, without leaving the editor.
- You need a character, place or lore entry suggested to fit what's already there.
- You want a logline, tags or a cover for the [Overview](https://docs.novelos.studio/guides/overview.md).
- You want a picture: a portrait, a map, a concept sketch, a Spark board image. Muse draws them inside the app.
- You want the Blueprint's **Generate Outline** to turn plot points into story beats.

## Use an outside agent when

- The question needs the whole book: "is Mara's scar on the same cheek in every chapter?"
- You want a report with quotes and paragraph numbers, like a continuity check, a timeline or a beta read.
- The job has several steps: read three chapters, compare them with Cast & World, then propose entries.
- You want to talk it through, push back and ask again.
- You want the result saved in many places at once, such as a comment on each flagged line.

## Using both

They work well one after the other. Plan the next scene with the Scene outline skill, then use Muse's Prose Rewrite on the one sentence in the draft you can't get right. Let the World bible sync propose a new place from the text, then have Muse draw it.

Your Muse API keys are never shared with outside agents, so connecting Claude Code doesn't hand it your Gemini or OpenAI account.

**Next:** [Tutorials](https://docs.novelos.studio/tutorials.md)
