Getting started

Install RunHuddle

RunHuddle requires macOS 14 or newer on Apple Silicon. Install and sign in to your agent CLIs separately; RunHuddle does not include model access or a provider subscription.

1. Click Download for macOS to get the current published installer. Release notes and older versions are also available.
2. Download its Apple Silicon DMG, open it and drag RunHuddle to Applications.
3. Launch the installed app. Keep it in that location so tracking hooks continue to find it.
4. Open the toolbar gear, then Connections, to check agent discovery and tracking.

Release builds use Developer ID signing and Apple notarization. You do not need Python, Swift or a source checkout to run the downloaded app. Intel builds have not been verified.

Start your first session

Choose New session, select an installed agent and an existing project folder, then review the launch options. If you include project notes, select them before editing your first prompt. No notes are included automatically.

The agent runs in RunHuddle’s embedded terminal. Use that terminal for prompts, questions, commands and approval requests. Your agent’s usual account, permissions and CLI behavior still apply. Reply extensions and development-channel setup are not required.

Sessions started outside RunHuddle can appear as recorded conversations. Exit an external session in its original terminal before resuming it here; do not start a duplicate to work around slow status updates.

Find your way around

• Sessions contains Active, All, Pinned and Archived views, with tool and project filters.
• Notes contains reusable project knowledge and saved session reports.
• Inbox collects input requests, unread results and observed unexpected terminal exits.
• Session info contains project tools, repository information, notes and continuation actions.
• The menu-bar switcher finds sessions without first navigating the main window.

See Workspace and sessions for navigation, or Agent connections if a CLI is missing.

Close, quit and return

Closing the window leaves RunHuddle running. When quitting, choose whether to keep terminals running or end them. Kept terminals reconnect with their history when you reopen the app. A Mac restart ends running processes; saved agent conversations can still be resumed.

Notifications and opening at login are optional. Configure them in Settings. Reopen the built-in introduction through Help → Getting started….