Skip to Content
ConceptsTerminal output

Terminal output

Every invocation prints a banner with the version to stderr:

pf v4.39 · my-service Node (pnpm)

stdout stays clean, so pf list, pf dl --list and other output can be piped. There is no output path that skips the banner.

Colors

Colors follow the usual environment variables:

VariableEffect
NO_COLORTurn colors off
FORCE_COLORTurn colors on, even without a terminal

Without a terminal

Anything with a terminal-only mode (the menu, pickers and prompts) falls back to static output when there is no TTY. Prompts return nothing on cancel, so commands that ask also have flags (--yes, --dry-run, --bucket, …) for scripts and CI.

Pictures

pf prints small pictures to stderr for some commands: an octopus mascot for pf repo, pf update and pf agent, and a confused figure on an unknown command or an uncaught error. They appear only on a color terminal that is wide and tall enough, never into pipes or logs.

VariableEffect
PF_NO_MASCOT=1 (or PF_NO_TRAVOLTA=1)Turn every picture off

pf art lists the pictures and which commands show them, and pf art show <name> previews one. You can map a command to a picture, or to none, in art.json. Your own pictures go in ~/.pf/art/, as plain text files with color escapes (.ansi).

Other environment variables

VariableEffect
PF_NO_UPDATE_CHECK=1Skip the update check
PF_NO_PLUGINS=1Do not load registry plugins (to debug)
PF_AGENTDefault agent CLI: claude, codex or cursor
PF_PROFILEThe profile for this run
PF_HOMEWhere pf keeps its state (default ~/.pf)
Last updated on