AI Copilot
AI Copilot is a chat with your book's context. Ask questions, request new or revised scenes, discuss structure — the AI knows which book you're working on.
Open the panel: the spark icon button on the right sidebar. Copilot tab.
Conversations
Each book has its own list of conversations — chat history is not shared between books.
| Action | How |
|---|---|
| New chat | The + button in the panel header |
| Switch | Conversation list button → pick from history |
| Rename | Double-click the conversation title |
| Delete | Conversation list → delete icon next to the title |
Action Confirmation (HITL)
When the AI wants to change book content — create a scene, rename an item, write text — it asks permission. You see a card describing the action.
- Approve — the action runs
- Reject — the action is canceled and the AI continues without it
While a decision is pending, you cannot send new messages.
Content Suggestions
When the AI proposes to write or change scene text, a suggestion card appears with a preview. You can expand the full text before deciding.
- Apply — the text is written to the scene
- Reject — the suggestion is canceled
Operations: replace text, append, prepend.
Scene Review
The AI analyzes the open scene and returns editorial feedback: pacing, POV, dialogue, weak spots.
Run it: Cmd+Shift+R or via the command palette → Scene Review.
The result appears in the chat as a regular message. If the scene is empty, review is unavailable.
Context Indicator
Below the input field, the current session's stats are shown: ↑ sent ↓ received · $cost — tokens sent to the AI and received from it, plus the approximate cost. Shown only while a conversation is active.
Context Window and Compression
When the context is ~80% full, a warning appears. You can:
- Compress — older messages are summarized and archived, freeing space. Compression can be undone with Undo compression.
- Start a new chat — a clean context without losing history.
The archived segment remains in the conversation and is shown as a collapsed "Archived" block.
Managing Messages
| Action | How |
|---|---|
| Copy a message | Context menu on the message |
| Retry a request | The Retry button below the last failed message |
| Stop generation | The Stop button in the input field |
Input field shortcuts: Enter — send, Shift+Enter — new line.
Book Context
The AI automatically receives the book structure, metadata, characters, and AI guide on every request. You can manage what gets passed in the knowledge base.
Troubleshooting
The AI stream froze or stopped responding. If a response takes too long, you'll see "AI response did not arrive in time — please try again." Retry the request or start a new chat with the + button.