Chapters

Chapter commands manage the chapter structure of your novel.
Alias: ch

Command	Alias	Description
`add`	`ad`	Add a new chapter
`list`	`li`	List all chapters
`name`	`na`	Set a chapter name
`clear-name`	`cn`	Remove a chapter name
`move`	`mo`	Move a chapter to a new position
`remove`	`rm`	Remove a chapter by index

nib chapter add

Add a new chapter.

Synopsis

nib chapter add [--name <name>] [--at <position>]

Flags

Flag	Description
`--name`	Set the chapter title
`--at`	Insert at a specific position (shifts existing chapters down)

The chapter is added to book.yaml automatically.

Examples

# Add a chapter at the end
$ nib ch ad --name "The Beginning"

# Insert a chapter at position 3
$ nib chapter add --name "Interlude" --at 3

List all chapters with their scene counts.

Synopsis

nib chapter list

Set a chapter name.

Synopsis

nib chapter name <index> <name>

Examples

# Name chapter 3
$ nib ch na 3 "The Turning Point"

Remove a chapter name.

Synopsis

nib chapter clear-name <index>

Move a chapter to a new position.

Synopsis

nib chapter move <from> <to>

Examples

# Move chapter 5 to position 2
$ nib ch mo 5 2

Remove a chapter from book.yaml.

Synopsis

nib chapter remove <index>

Examples

# Remove chapter 3
$ nib ch rm 3

Scene files are not deleted when you remove a chapter. They stay in the scenes/ directory and can be reassigned later.