GooeyPi

GooeyPi is a desktop workspace for Pi, OMP, and Prime Agent. It gives all three coding agents the same friendly interface on macOS, Linux, and Windows while leaving each harness in charge of its own models, logins, and saved sessions.

Three harnesses, one workspace

Use the switcher in the top-left corner to move between Pi Work, OMP Work, and Prime Work. GooeyPi detects the harnesses installed on your computer and shows the ones that are ready. You can refresh detection or set a custom executable path in Settings.

Each harness keeps its own projects, sessions, model list, provider visibility, and running work. Switching harnesses changes the workspace without stopping work already running in another one.

You only need one harness to get started:

• Pi is the base coding-agent harness in the Pi family.
• OMP adds its own plugins, commands, and approval controls.
• Prime Agent adds Prime's provider integrations and native heartbeats.

What you can do

Work with agents

• Stream conversations with Markdown, reasoning summaries, tool activity, retries, and context compaction.
• Choose a model, reasoning level, and Fast mode when the selected model supports it.
• Queue a follow-up or steer an agent while it is working.
• Paste or drop PNG, JPEG, GIF, and WebP images into a prompt when the model supports vision.
• Resume, rename, search, archive, and restore persistent sessions.
• Read OMP child-agent history in the inspector while keeping the parent conversation open.
• See running, finished, failed, and waiting-for-input work in one Activity view, then clear items you have handled.

Keep projects organized

• Add local folders and reopen sessions grouped by project.
• Search projects, chats, and branches from the sidebar.
• Switch between linked Git worktrees from the composer.
• Save project setup and run scripts and launch them in the integrated terminal.
• Create a branch worktree and open it as a new GooeyPi workspace.
• Mention another top-level session with @session, copy its UUID, or let agents create and message model-selected sessions for parallel work.

Use the built-in coding workspace

• Review Git status and diffs, stage or unstage files, restore changes with confirmation, and commit without leaving the app.
• Browse project files and reveal them in your system file manager.
• Open multiple terminal tabs for a session. Highlight terminal output to attach it to the next prompt.
• Open the right-hand Summary, Changes, Browser, or Files panel whenever you need it.

Browse with shared context

• Use an isolated in-app browser with an address bar, navigation history, downloads, and an external-browser handoff.
• Point at page elements and add notes. GooeyPi attaches those annotations to your next message.
• Enable browser control so an agent can open and operate its own tabs. You can watch its cursor and work in the same tabs when you want to take over.

Automate repeat work

• Create one-time or recurring schedules for the active harness.
• Pick the project or existing session, model, reasoning level, timezone, and Fast mode.
• Run a schedule immediately, pause or resume it, and inspect the result and run history.
• Manage Prime heartbeats alongside GooeyPi schedules when Prime Agent exposes them.
• On macOS, opt in under Settings → General to keep scheduled work running from the menu bar after closing the window, and optionally launch GooeyPi in the background at login. The packaged app also accepts --background to start without opening its window.

Add capabilities

The Capabilities page brings together packages, plugins, extensions, skills, prompts, and MCP servers. GooeyPi can manage local stdio MCP definitions for OMP and adapter-enabled Pi. Network MCP and authentication stay under the selected harness's direct control; those entries are visible but read-only in GooeyPi, with bounded definition-only removal available for cleanup. MCP discovery reports a warning when a settings file exceeds its supported size, keeping unrelated capabilities from hiding supported MCP rows.

GooeyPi also ships optional capabilities for:

• Let an agent ask you a small set of questions in a native dialog.
• Give agents controlled access to the in-app browser.
• Use TryCUA computer control when the separate CUA Driver is installed.

Ask User and computer control are off by default. You can enable, disable, or remove capabilities from the app.

Talk instead of type

• Dictate prompts with OpenAI, Groq, Deepgram, or a local whisper.cpp installation.
• Open the realtime voice companion to search, discuss work, and start a task in the currently selected harness.
• Choose an animated desktop pet that reacts while an agent works and carries the realtime voice controls. GooeyPi includes the Orb and GooeyPi pets and can discover compatible Codex pets.

Make it comfortable

• Choose a light, dark, or system theme and adjust the interface text size.
• Use English, Japanese, or Simplified Chinese interface text with operating-system regional dates and times.
• Reduce motion, resize the workspace panels, or let them become overlays in a narrow window.
• Use keyboard navigation and the command palette for common actions.

Get started

1. Install Pi, OMP, Prime Agent, or any combination of the three.
2. Sign in or configure a model provider through each harness's own CLI.
3. Download GooeyPi from GitHub Releases, or run it from source.
4. Add a project folder and start a session.

GooeyPi checks common install locations automatically. If a harness is missing, open Settings → Harness to refresh detection or choose its executable.

This is the beginning of the README. Read the rest at the original. Read the full README ↗