Skip to content
Esc
↑↓navigate↵open⌘Jpreview
On this page

Workspace and Navigation

Focus on one Terminal, inspect its live context, review Sessions, and move through recent Terminals with browser-style Back and Forward history.

PonyMux keeps one Terminal at the center and brings supporting information into view only when you need it. The workspace controls are different views of the same durable Terminal, not separate places you have to keep in sync.

LISTS
Agents›Polish launch documentation
Polish launch documentationcodex· ponymux-web › tasks
Review release checklistclaude· ponymux › shipping
Refine theme tokenscodex· design-system › components
Triage onboarding feedbackclaude· ponymux-web › tasks
Benchmark startup timecodex· playground › experiments
Archive migration noteszsh· ponymux › etc
OpenAI Codex(v0.132.0)
model:
gpt-5.6-sol low /model to change
directory:
~/Works/ponymux-web

Polish the product documentation and verify the visual examples.

I’ll update the workspace examples, check both themes, and run the site validation.

Read components/demo/AppShellDemo.astro
Edited components/demo/TerminalListDemo.astro(+6 −5)
Ran bun run check→ passed

Working(4s • esc to interrupt)

Sessions
Sep 7
Polish launch documentation

Refresh the product story and make the workspace easier to understand.

Codex · just now
New Quick Terminal

WORKING DIRECTORY

LIST

PET

Appears when a session starts.

AGENT INTEGRATIONS
Claude Code2 active · last event just now
Codex1 active · last event just now

Notifications

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.
Mochi

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
Follow SystemautoAuto

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 later.

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 Terminal
Archive Terminal
Show Inspector

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/claude-hook

Codex

ConnectedAgent status and session history are tracked.
Config file~/.codex/config.toml
Forwarder script~/Library/Application Support/PonyMux/codex-notify

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.

Reset

Reset all settingsYour Terminals, sessions, theme and agent connections stay.
PonyMux Workspace Try Focus, Sessions, Inspector, Quick Terminal, Back and Forward, or the sidebar controls.

Focus Mode

Select the viewfinder button in the toolbar or press ⇧⌘F to give the window to the current Terminal. Focus Mode hides the sidebar and Terminal list, collapses an open Quick Terminal, and lets the main Terminal use the available space.

The toolbar moves out of the way and returns when you move the pointer to the top edge. You can still open Sessions or the Inspector while focused. Leaving Focus Mode restores the normal columns; any shell, agent, or Quick Terminal process continues running throughout the change.

Focus Mode is temporary and is not restored the next time PonyMux launches.

Inspector

Open the Inspector from the trailing-sidebar button or press ⌥⌘B. It is a resizable column for facts and actions that belong to the selected Terminal:

  • Its current working directory, with copy and Open in… actions.
  • Its List membership.
  • The current provider, model, effort, context facts, and session ID when available.
  • Fork Session while the current conversation supports it.
  • The pet assigned to that Terminal.

The Inspector remains useful for a sleeping Terminal by showing its saved working directory and other durable information. Archived and trashed Terminals use a read-only form because their organization cannot be edited until they are restored.

Sessions

Press ⌥⌘V to open the Sessions panel for the selected Terminal. Unlike the Inspector, which describes what is current, Sessions is the timeline of agent conversations that have happened there. Use it to review recaps, Resume an older conversation, or Fork a branch of work.

The panel can appear over the Terminal or stay pinned beside it. Its presentation preference is remembered independently of whether a particular Terminal has the panel open.

Quick Terminal

A Quick Terminal is a temporary shell attached to the currently selected Terminal. Use it for a development server, a log stream, git status, or another small task that belongs beside the main session but does not deserve its own durable Terminal.

Open and manage Quick Terminals

  • Press ⌥⌘J to show the current Quick Terminal. If none exists, PonyMux creates one.
  • Press ⌥⌘N to create another Quick Terminal for the selected Terminal.
  • Select a chip in the dock to switch between Quick Terminals.
  • Drag the panel edge to change its height.
  • Use ⌥⌘D to keep the dock visible instead of letting it auto-hide.
  • Close a Quick Terminal from its chip or context menu. PonyMux asks first if a foreground process is still running.

Each durable Terminal owns its own set of Quick Terminals. Switching to another Terminal swaps the visible dock, while Quick Terminals attached to the previous one keep running. Returning restores the Quick Terminal you last selected there.

Deliberately temporary

A Quick Terminal:

  • Is not persisted across app launches.
  • Has no row in All Terminals or a List.
  • Does not create session history.
  • Does not receive a PonyMux Terminal identity.
  • Does not report Claude Code or Codex integration events.
  • Is destroyed when its host Terminal leaves the active workspace.

If a command or agent conversation should be named, organized, resumed, or reviewed later, create a regular Terminal instead. Its List assignment and starting directory depend on the collection in which it is created.

Back and Forward history

PonyMux records Terminal and collection changes as navigation history. Use the toolbar arrows or ⌘[ and ⌘] to return to where you were without finding the same row again.

Press and hold, right-click, or Control-click either arrow to open up to ten recent steps on that side and jump directly to one. Entries show enough Terminal and collection context to distinguish visits made from different Lists. History skips destinations that no longer exist or no longer belong to that collection.

Last updated on Sep 12, 2026