AI tools: read / edit / create / delete / search + diff + accept / reject
The AI Coach doesn't only suggest text — it has a toolset to read, write, create, delete files directly. Every change passes through a diff view before landing.

What the AI can do
| Tool | What |
|---|---|
| Read file | Coach decides which files to consult |
| Edit file | Modify part of a file |
| Create file | Add a chapter / note |
| Delete file | Move to trash (not permanent) |
| Search | Full-book search ("every sentence with 'lighthouse'") |
| List files | Tree of files (e.g. "list Notes folder") |
| Stats | Word counts, chapter counts, entity occurrences |
Two edit modes
Coach panel header toggle:
Suggestion mode (default)
The Coach replies in the chat only — says "I'd revise it like this: …" and you decide whether to paste it back.
Best for:
- Wanting opinions, keeping control
- Small tweaks
- Uncertain about what the AI will produce
Direct edit mode
The Coach can write directly into the draft — but before it does:
- Auto-versions: Auto-version rules
- Writes into the draft
- Opens Change Review: Change Review accepts / rejects per passage
Best for:
- Bigger rewrites
- Trusting the AI's direction, skipping the manual paste-back
Diff view (Direct edit mode)
After the Coach writes, the editor switches to diff:
- Green background = passages added by the AI
- Red background + strikethrough = passages removed
- Each block has ✓ "Accept" / ✗ "Reject" on the right
Four ways to accept / reject
| Action | What |
|---|---|
| Per-block ✓ / ✗ | Review each |
| Edit the block directly | Accept the direction, refine yourself |
| Accept all | Trust the AI direction |
| Reject all | Revert the whole chapter |
Cross-file diff
If you ask "switch the whole book from first to third person", the AI edits many files. Diff view walks file by file — the file tree marks which files still need review.
How to see what tools the AI used
Each message header shows "AI used N tools: read(Chapter 3) / edit(Protagonist.md) / search('lighthouse')" — transparent record of what happened.
Related
Was this helpful?