Penseed

by Reborn Walker
5
4
3
2
1
Score: 51/100

Description

Narrative consistency plugin for novelists

Reviews

No reviews yet.

Stats

0
stars
513
downloads
0
forks
63
days
2
days
2
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
81
commits

Latest Version

2 days ago

Changelog

Fix the edit reminder:

  • It now appears while you're still on the edited note (about 1.5s after you pause typing), instead of only after switching to another note.
  • It no longer disappears when you click back into the changed note; it stays until you re-analyze or dismiss it.
  • It clears automatically if you revert the edit.

README file from

Github

Penseed Obsidian Plugin

Never lose a plot thread — and never spoil your own mystery.

Penseed is an AI-powered consistency companion for novelists. You keep writing — Penseed's AI does the remembering for you. Every time you analyze a chapter, it automatically reads the text, extracts every planted thread, character detail, and world rule, and quietly warns you before a contradiction slips past. There are no lists to maintain by hand and nothing to update manually — the AI keeps the structured record it extracts (threads, characters, and rules) up to date on its own. It also tracks what your reader knows at every point in the story — separate from what each character knows — so you never give away a twist too early.

The problem with long novels

Most writing tools get worse the longer your book becomes. They work by re-reading your entire manuscript from page one every time you ask for help — so at chapter 50 they feel slow, at chapter 200 they feel expensive, and at chapter 500 they start forgetting what happened in chapter 3.

Penseed works the opposite way. It remembers as you write, like a tireless editor who has read every chapter and never forgets a single detail. Analyzing chapter 500 never means re-reading chapters 1 through 499.

A typical writing plugin Penseed
How it remembers Re-reads your whole book on every request Reads each chapter once, then keeps a tidy, organized record of what it found
Finding a detail Skims everything from the start Recalls only the relevant chapters
At 500+ chapters Slow, costly, forgetful Fast, affordable, precise
Foreshadowing Not tracked Plant → track → payoff, fully managed — automatically
Contradictions You catch them by re-reading Flagged automatically before your readers notice
Reader knowledge Not tracked Tracked separately from character knowledge, so twists stay hidden
Rewrites that ripple Re-check every later chapter Re-checks only the chapters your edit affects
Who does the work You maintain every list by hand The AI extracts and tracks it as you write

Why Penseed stays fast

Say you rewrite chapter 205 of a 500-chapter novel. Most tools respond by re-reading all 295 chapters that come after it — every single one — to catch up. That's slow and expensive, and you pay for all of it.

Penseed doesn't. It already knows your story, so it can tell which of those later chapters your change actually affects — usually just a handful — and it re-checks only those, one after another in order. You pay for a few chapters, not hundreds.

That's the whole idea behind Penseed: read each chapter once, remember every thread, character, and rule it introduces, and never make you re-read the book from the start. It stays fast and cheap no matter how long your novel gets — and it never needs to keep your original text to do it.

What Penseed tracks for you

Everything below is tracked automatically by Penseed's AI — you don't maintain any of it by hand. You write the story; the AI reads it and maintains these structured records for you, updating them whenever a chapter changes.

  • Foreshadowing — the one thing almost no other tool does. Penseed remembers every thread you plant, tells you which ones are still dangling, and which ones you've already paid off.
  • Your cast and world — characters, places, items: their names, aliases, and how they change chapter by chapter.
  • Contradictions — if an eye color, a kingdom's history, or a magic rule quietly changes, Penseed flags it before your readers do.
  • World rules — so names, places, and mechanics stay locked in place across your entire series.
  • Reader knowledge — what the reader knows, and when they learned it, kept separate from what each character knows (see below).
  • Edits that ripple — rewrite chapter 100 when you're already at chapter 200, and Penseed tells you exactly which later chapters are affected, instead of making you re-check everything.

Never spoil your own mystery

You know the killer is the butler. Your readers shouldn't — not until chapter forty. Penseed is the only consistency engine that tracks what your reader knows separately from what each character knows.

As you analyze each chapter, Penseed records what the reader has learned so far, and which characters know it too. Rewind the reader-knowledge timeline to any chapter and see exactly what a reader knows at that point — so you can:

  • catch a character casually mentioning a secret the reader hasn't discovered yet,
  • plant dramatic irony on purpose, where the reader knows more than a character,
  • keep track of what the reader thinks they know — including things they've only suspected, or misunderstood.

How to use it

  1. Analyze a chapter — Run Penseed: Analyze Current Note from the command palette. Penseed binds the note to a project, analyzes it, and shows how many new threads and characters it found.

  2. Analyze a whole manuscript — Click the book-open icon in the left ribbon, or run Penseed: Analyze whole manuscript with Penseed, to batch- analyze a book you've already written, or re-analyze it after a revision. See "Bringing in a whole book at once" below for the full walkthrough.

  3. Open the Foreshadowing Board — Click the layout-grid icon in the left ribbon, or run Penseed: Open Foreshadowing Board, to open a four-column board (Pending / In Progress / Resolved / Cancelled). Drag a clue between columns to update its status, kept in sync with the web app. For the full board with relations and editing, open the web app.

  4. Jump to a chapter from a card — Double-click any card on the board to open the matching chapter note. Penseed scrolls to the exact sentence the card refers to and highlights it, so you don't have to hunt through the chapter yourself.

  5. Open a foreshadowing in the web app — Click the external-link icon on any card to open that foreshadowing's full detail view. Penseed jumps straight to the right project and opens the detail drawer, no hunting required.

Analyze in order — from chapter one

Penseed remembers your story the way a careful editor does: by reading it in order, from the first chapter onward. Each chapter's analysis builds on every chapter before it. Chapter 50 is analyzed knowing what happened in chapters 1–49.

So when you first bring a novel into Penseed, analyze your notes one chapter at a time, starting from chapter one and moving forward in order. Don't skip ahead — if you analyze chapter 10 before chapters 1–9, Penseed can't see the clues those earlier chapters planted.

Why order matters. Foreshadowing is a chain: a hint you plant in chapter 3 pays off in chapter 20. If chapter 20 is analyzed before chapter 3, Penseed can't connect that payoff back to its hint, and the threads, characters, and world rules it records come out wrong. Because every later chapter then builds on that wrong note, a single out-of-order chapter can quietly throw off everything after it — the butterfly effect.

Bringing in a whole book at once

If you're adding a novel you've already written — dozens or hundreds of chapters — you don't have to work through it one note at a time. Use Analyze whole manuscript and Penseed reads every note in your project's folder, sorts the chapters into order, and analyzes them from the first to the last. You don't have to keep track of where you are, and you can't accidentally skip a chapter — the plugin pulls the complete book straight from your vault.

How it works

  1. Click the book-open icon in the left ribbon, or run Penseed: Analyze whole manuscript with Penseed from the command palette.
  2. Penseed scans your project folder and sorts every note into three groups:
    • Chapters (auto) — detected chapter notes, pre-selected and analyzed in order.
    • Review these notes — notes Penseed isn't sure are chapters; tick the real ones.
    • Excluded — planning material (character sheets, world bibles, outlines) kept out so spoilers don't leak into your analysis. Tick or untick any note before you start.
  3. The next screen shows a preview — how many chapters are new, unchanged, and changed, plus the estimated credit cost — before anything runs.

Revising later

Already brought the book in and revising? Run Analyze whole manuscript again. Because the plugin reads straight from your vault, it always has the complete book, so it can compare every chapter and re-analyze only the ones that changed — unchanged chapters are skipped at zero cost. No copy-paste, no hunting for which chapter you edited, and no risk of leaving a chapter out, which would break the chain of analysis downstream.

When you edit an earlier chapter

If you rewrite chapter 100 while you're already at chapter 200, Penseed tells you which later chapters are now out of date — a status-bar badge shows how many.

Click the badge to see the list, then choose Batch re-analyze outdated chapters. Penseed pulls those chapters straight from your vault and re-analyzes them in order, so the chain stays intact — no copy-paste, no hunting for the right text.

Privacy

When you choose to analyze a note, the plugin sends that note's content to Penseed for analysis only. By default Penseed uses the text to build structured records about your story — threads, characters, and world rules — and does not store the original text itself, unless you turn on Save chapter text yourself (see below).

You can optionally turn on Save chapter text in Penseed (off by default). When it's on, Penseed keeps an encrypted copy of each chapter's text so it can re-check later chapters after you rewrite an earlier one — no re-pasting needed. Turn the option off and all saved copies are deleted.

The plugin does not read or upload any other files, does not watch your vault, and does not collect telemetry.

Privacy policy: https://penseed.app/privacy

Setup

  1. Install the plugin.
  2. In Settings → Penseed, click Connect Penseed.
  3. Your browser opens — sign in to Penseed with your Google account and click Authorize.
  4. Switch back to Obsidian. You're connected. There's no token to copy, and your session renews automatically, so you won't be signed out.

License

MIT. See LICENSE.