otty / apps

All apps/pi

pi

A terminal-based coding agent.

Runs as pi|macOS, Linux, Windows|pi.dev

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

pi in your home directory Every rule on this page, by file

· settings.json Sync

· extensions/ Sync

· sessions/ Exclude

· logs/ Exclude

· cache/ Exclude

· auth.json Never synced

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/pi/otty.tomlThe file this page is generated from

id = "pi"

name = "pi"

homepage = "https://pi.dev"

description = "A terminal-based coding agent."

icon = "theSVG:pi"

executables = ["pi"]

[dotfiles]

# pi keeps everything under ~/.pi/agent. Extensions are hand-written

# TypeScript; settings.json is the agent's own preferences.

paths = ["~/.pi/agent/settings.json", "~/.pi/agent/extensions/"]

exclude = [

"~/.pi/agent/sessions/",

"~/.pi/agent/logs/",

"~/.pi/agent/cache/",

]

# Mode 0600. pi and omp share a codebase but not a credential store.

secret = ["~/.pi/agent/auth.json"]

# No machine_lines: settings.json carries UI preferences and a changelog

# marker, with no absolute paths. Anything machine-specific is in an

# extension's own source, which syncs whole.

[commands]

format = 1

label = "Run the coding assistant"

description = "Start pi with a prompt, choose provider, model and session handling, or run non-interactively. Extension flags, skills and themes are left out."

quality = "ai-draft"

parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = false, short_bundles = false }

[[commands.source]]

id = "help"

kind = "help"

revision = "pi --help (local)"

evidence = """

Usage:

pi [options] [@files...] [messages...]

--provider <name> Provider name (default: google)

--model <pattern> Model pattern or ID (supports "provider/id" and optional ":<thinking>")

--print, -p Non-interactive mode: process prompt and exit

--continue, -c Continue previous session

--resume, -r Select a session to resume

--no-session Don't save session (ephemeral)

--thinking <level> Set thinking level: off, minimal, low, medium, high, xhigh

--no-tools, -nt Disable all tools by default (built-in and extension)

--append-system-prompt <text> Append text or file contents to the system prompt (can be used multiple times)

--no-context-files, -nc Disable AGENTS.md and CLAUDE.md discovery and loading

--offline Disable startup network operations (same as PI_OFFLINE=1)

"""

[[commands.field]]

id = "messages"

label = "Prompt"

description = "Initial message. Prefix a file path with @ to include it."

type = "string"

position = 0

multiple = true

sources = ["help"]

[[commands.field]]

id = "print"

label = "Non-interactive (print and exit)"

type = "boolean"

option = ["--print", "-p"]

sources = ["help"]

[[commands.field]]

id = "provider"

label = "Provider"

type = "string"

option = ["--provider"]

sources = ["help"]

[[commands.field]]

id = "model"

label = "Model"

description = "Pattern or ID; provider/id and :thinking suffix are accepted."

type = "string"

option = ["--model"]

sources = ["help"]

[[commands.field]]

id = "thinking"

label = "Thinking level"

type = "enum"

option = ["--thinking"]

choices = [{ value = "off", label = "Off" }, { value = "minimal", label = "Minimal" }, { value = "low", label = "Low" }, { value = "medium", label = "Medium" }, { value = "high", label = "High" }, { value = "xhigh", label = "Extra high" }]

sources = ["help"]

[[commands.field]]

id = "continue"

label = "Continue previous session"

type = "boolean"

option = ["--continue", "-c"]

sources = ["help"]

[[commands.field]]

id = "resume"

label = "Pick a session to resume"

type = "boolean"

option = ["--resume", "-r"]

sources = ["help"]

[[commands.field]]

id = "no_session"

label = "Ephemeral (do not save session)"

type = "boolean"

option = ["--no-session"]

sources = ["help"]

[[commands.field]]

id = "no_tools"

label = "Disable all tools"

type = "boolean"

option = ["--no-tools", "-nt"]

sources = ["help"]

[[commands.field]]

id = "no_context_files"

label = "Skip AGENTS.md / CLAUDE.md"

type = "boolean"

option = ["--no-context-files", "-nc"]

sources = ["help"]

[[commands.field]]

id = "append_system_prompt"

label = "Append to system prompt"

type = "string"

option = ["--append-system-prompt"]

multiple = true

sources = ["help"]

[[commands.field]]

id = "offline"

label = "Offline startup"

type = "boolean"

option = ["--offline"]

sources = ["help"]

[[commands.task]]

id = "one_shot"

label = "One-shot prompt"

fields = ["messages", "print", "model"]

required = ["messages", "print"]

set = { print = [true] }

[[commands.task]]

id = "resume"

label = "Continue last session"

fields = ["continue", "messages"]

required = ["continue"]

set = { continue = [true] }

[[commands.group]]

id = "basic"

label = "Basic"

fields = ["messages", "print", "provider", "model", "thinking", "continue", "resume"]

[[commands.group]]

id = "advanced"

label = "Advanced"

fields = ["no_session", "no_tools", "no_context_files", "append_system_prompt", "offline"]

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/pi. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these keeps the credential file out.