Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Features

Features, in two groups: the surfaces of an everyday session, then what extends and customizes the agent. Worked examples are at the end.

Interactive surfaces

These are the parts of the TUI you touch every session:

Extend and customize

These add capabilities or change how the agent runs:

FeatureWhat it adds
Plan mode, goals, and vibeEngine modes that plan, pursue an objective, or direct workers
SkillsReusable, on-demand instructions
PluginsPackaged extensions
HooksTypeScript modules that run on events with pi.on(...)
MCPModel Context Protocol servers and tools
BranchingForking a session into parallel lines of work
SubagentsDelegating work to background agents
MemoryProject-scoped recall across sessions
ProfilesIsolated config, sessions, and state per name
PersonalitiesNamed voice and behavior presets
SpeechText-to-speech output
Export and importMoving sessions in and out
ConnectorsThird-party app integrations
ApprovalsThe approval-mode boundary in depth
SecretsCredentials the agent uses by placeholder and never sees
Code reviewReviewing branches, commits, and uncommitted work
Non-interactive modeRunning Veyyon from a script

Recipes

For worked examples, see the Task guides. For the full command and setting reference, see Reference.