Skip to content

Manuscript

Manuscript commands handle building, status, and AI-assisted editing.
Alias: ma

CommandAliasDescription
buildbuAssemble manuscript and build output format
statusstShow manuscript statistics
toctoTable of contents with dotted notation
searchseSearch scenes with a plain-English query
critiquecrAI-powered narrative review
proofprAI-powered copy-editing
voicevoCheck character voice consistency

nib manuscript build

Assemble scenes into a complete manuscript.

Synopsis

nib manuscript build [range] [--format <fmt>]

Flags

FlagDefaultDescription
--formatmdOutput format: md, docx, pdf, epub

The optional range argument limits the build to specific chapters or scenes using dotted notation.

Examples

# Build entire manuscript as Markdown
$ nib ma bu

# Build chapters 1-5 as DOCX
$ nib manuscript build 1-5 --format docx

# Build a single scene as PDF
$ nib manuscript build 3.2 --format pdf
Output is written to the build/ directory. DOCX, PDF, and EPUB formats require Pandoc.

nib manuscript status

Show word count, scene stats, and any unassigned scenes.

Synopsis

nib manuscript status

nib manuscript toc

Display the table of contents with dotted notation for every chapter and scene.

Synopsis

nib manuscript toc

nib manuscript search

Search scenes with a plain-English query.

Synopsis

nib manuscript search <range>

Examples

# Search chapters 1-3
$ nib manuscript search 1-3

# Search a range of scenes
$ nib ma se 1.1-2.3

nib manuscript critique

Review scenes for narrative issues: pacing, character consistency, plot holes, and dialogue quality.

Synopsis

nib manuscript critique <range>

Uses your STYLE.md and character profiles for context.

Examples

# Critique chapter 3
$ nib manuscript critique 3

# Critique a specific scene
$ nib ma cr 5.2

nib manuscript proof

Copy-edit scenes for grammar, spelling, punctuation, and style consistency.

Synopsis

nib manuscript proof <range>

Respects your STYLE.md preferences so it won’t “correct” intentional stylistic choices.

Examples

# Proof chapters 1-3
$ nib manuscript proof 1-3

nib manuscript voice

Check character voice consistency across the manuscript.

Synopsis

nib manuscript voice