Polish launch documentation
Refresh the product story and make the workspace easier to understand.
Codex · just nowNotifications
Permission requestsAn agent is blocked and waiting for you to allow something.
Finished turnsAn agent stopped and is ready for your input.
Agent errorsAn agent stopped because something went wrong.
Pets
Show a pet for every live sessionA pet walks the window title bar for each running agent. Click one to jump to its Terminal.
New Terminals getEach Terminal is given one when you create it and keeps it. Change any of them in its inspector.
6 pets available6 built-in. Add custom pets to ~/.codex/pets/.
Sessions
Resume sessions on launchEach Terminal whose agent was still running resumes its session when you open it.
Permission level for resumed sessionsWhat the agent can do when a session resumes or forks.
Ask before quitting with live agentsShow a confirmation before quitting when agents are still running.
THEMES
~/ponymux ❯ claude
● Reading Settings.swift
bold normal dim err warn
● Reading Settings.swift
bold normal dim err warn
Font
FontWhich monospace font the Terminal uses.
Font sizePoint size for Terminal text.
Font for Chinese and Japanese charactersKeep shared characters consistent on the same line.
Cursor
Cursor shapeHow the cursor looks in the Terminal.
Cursor blinkWhether the cursor blinks when idle.
Screen Effect
Effect for new TerminalsCursor animation for new Terminals. Change it per Terminal from its menu.
Cursor Warp
Behavior
Let sessions name TerminalsUse the session topic and update it as the conversation moves.
Copy on selectSelecting Terminal text puts it on the clipboard.
New Terminal inherits working directoryOpen in the same folder as the Terminal you are viewing.
Shell
Default shellWhich shell new Terminals start with.
Shell integrationLet PonyMux track each shell’s working directory.
Window
New Terminal
Quick Terminal
Focus Mode
Navigation
Back
Forward
Terminal
Rename…
Inspector
Search…
Reserved by the terminal
Copy, paste, select all, clear, font size, scrollback, line editingThese shortcuts go to the shell and agent, not PonyMux.
Claude Code
ConnectedAgent status and session history are tracked.
Config file~/.claude/settings.json
Forwarder script~/Library/Application Support/PonyMux/bin/ponymux-hook.sh
Codex
ConnectedAgent status and session history are tracked.
Config file~/.codex/hooks.json
Forwarder script~/Library/Application Support/PonyMux/bin/ponymux-hook.sh
Grok
ConnectedAgent status and session history are tracked.
Config file~/.grok/hooks/ponymux.json
Forwarder script~/Library/Application Support/PonyMux/bin/ponymux-hook.sh
PonyMux only adds or removes its own entries in the config file, and backs it up first.
This copy of PonyMux
PonyMuxdev.ponymux.app
Session data~/Library/Application Support/PonyMux
Event socket~/Library/Application Support/PonyMux/events.sock
Diagnostics
Debug LogLive view of PonyMux activity, filtered by area.
Log fileInfo and error entries kept on disk, so they survive a restart.
Transcript Index
Transcript searchIndex agent transcripts for full-text search.
1,045 sessions · 133K messagesIndex size: 157 MB
Reset
Reset all settingsYour Terminals, sessions, theme and agent connections stay.
