Skip to content

Profiles

Profile commands manage character profiles and interactive sessions.
Alias: pr

CommandAliasDescription
addadCreate a new character profile
listliList all profiles
editedOpen a profile in your editor
talktaRole-play as a character
removermRemove a profile

nib profile add

Create a new character profile.

Synopsis

nib profile add <slug>

Creates characters/<slug>.yaml with a template you can fill in.

Examples

$ nib pr ad elena
# creates characters/elena.yaml

nib profile list

List all character profiles in the project.

Synopsis

nib profile list

nib profile edit

Open a character profile in your editor.

Synopsis

nib profile edit <slug>

nib profile talk

Launch an interactive session where the agent role-plays as a character at a specific point in your story.

Synopsis

nib profile talk <slug> <scene>

The conversation is grounded in the character’s profile, personality, and all indexed continuity data up to the specified scene.

Examples

# Interview Elena at chapter 12, scene 3
$ nib pr ta elena 12.3

nib profile remove

Remove a character profile.

Synopsis

nib profile remove <slug>