← all repositories
lingfengQAQ/webnovel-writer

Claude Code plugin that keeps million-word novels canon-compliant

It exists because LLMs forget their own plot twists after chapter fifty, so this system acts as a memory layer and lore bible for long-form serial fiction.

webnovel-writer
Velocity · 7d
+55
★ / day
Trend
accelerating
star history

What it does

Webnovel Writer is a Claude Code plugin that acts as a project manager for AI-assisted serial fiction. It maintains a structured story-system directory—treating MASTER_SETTING.json as the single source of truth for world-building, characters, and foreshadowing—while using RAG with embedding and reranker APIs to inject relevant context before each writing session. The goal is to let authors churn out hundreds of chapters without the model contradicting its own established canon.

The interesting bit

Instead of treating each chapter as a standalone prompt, the system runs a pre-flight check, reads the full story state, and commits accepted chapters back into a projection model that updates summaries and a memory_scratchpad.json. It even tracks reader-retention mechanics—Hooks, Cool-points, and “debt tracking”—as first-class metadata, which is a level of narrative accounting rarely seen in developer tools.

Key highlights

  • Claims to support serials up to roughly two million words by maintaining a strict separation between story truth (.story-system/) and read-model projections (.webnovel/).
  • Ships with 37 built-in genre templates to bootstrap world-building.
  • Enforces a write-read-commit loop: pre-flight context injection, chapter generation, and post-hoc state updates via commit projection writers.
  • Includes a read-only dashboard for browsing project state, entity graphs, and chapter health.
  • Licensed under GPL v3.

Caveats

  • Requires external API keys for embedding and reranking services; the README lists ModelScope and Jina AI as defaults, so it is not fully self-contained out of the box.
  • It is explicitly a Claude Code plugin, so you must already be inside the Claude Code ecosystem to use it.
  • The “200万字” scale is a stated design target, but the README offers no benchmarks or stress-test data to confirm it.

Verdict

Worth a look if you are using Claude Code to generate long-form fiction and are tired of manually retconning character names. Everyone else can safely skip.

Frequently asked

What is lingfengQAQ/webnovel-writer?
It exists because LLMs forget their own plot twists after chapter fifty, so this system acts as a memory layer and lore bible for long-form serial fiction.
Is webnovel-writer open source?
Yes — lingfengQAQ/webnovel-writer is open source, released under the GPL-3.0 license.
What language is webnovel-writer written in?
lingfengQAQ/webnovel-writer is primarily written in Python.
How popular is webnovel-writer?
lingfengQAQ/webnovel-writer has 6.1k stars on GitHub and is currently accelerating.
Where can I find webnovel-writer?
lingfengQAQ/webnovel-writer is on GitHub at https://github.com/lingfengQAQ/webnovel-writer.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.