Desktop

The desktop app is a native client that runs the AgentTeams web app and adds screen-region capture, annotation, native notifications, updates, and pinned project tabs. It supports macOS and Windows.

When to use it

Use the desktop app when you need more than the browser:

• capture part of the screen and send it with a runner request
• annotate a captured image before handing it to an agent
• keep multiple projects pinned in a local sidebar
• combine web workflows with OS-level shortcuts, notifications, and updates

Main screen

The desktop app runs the web app as-is and adds a project sidebar on the left plus screen capture.

Project sidebar

The left sidebar shows Home and pinned projects. When you open a project from the web home page, it is added to the pinned list, and you can switch between pinned project tabs without returning to the full list.

Sidebar width and visibility, pinned projects, and the last active tab are saved and restored on the next launch. On narrow windows, the sidebar auto-hides to prioritize the web area.

Screen capture and annotation

The default capture shortcut is ⌘⇧8 on macOS and Ctrl+Shift+8 on Windows.

Capturing a region with the shortcut opens the editor first. Annotate the capture and write a prompt.

The capture editor supports dark mode only.

The capture panel in the bottom-right then lets you keep capturing (Continue) or create a runner request from the collected captures (Create new request).

Local agent — pilot

The local agent button in the top bar opens a panel on the right. You can explicitly choose between two engines:

• Installed agent delegation (E1) — runs Claude Code already installed on this computer using its existing login and subscription. It does not ask for a model API key; billing follows the user’s subscription.
• Direct model API call (E2) — Electron main calls the Messages API with the Anthropic API key stored by the user. Billing follows the user’s Anthropic Console credits.

E2 conversation and AgentTeams context lookup work without installing Claude Code or external executables such as agentteams, node, npm, or npx.

Where the key is stored

The Anthropic API key entered for E2 is encrypted with OS secure storage (macOS Keychain / Windows Credential Manager) and stays on this computer only. Its original value never leaves Electron main or reaches AgentTeams servers, and if it appears in run output it is automatically replaced with ***. E1 does not require or use this key.

Where OS secure storage is unavailable, the key is not written to disk and is kept for the current session only. The panel says so explicitly, and you will need to enter the key again after quitting the app.

Setup

1. Choose an engine — Select E1 (Claude Code) or E2 (Anthropic API). E1 is the default when Claude Code is detected, and you can switch at any time.
2. Register an E2 key — The Anthropic API key field appears only while E2 is selected. Verify and save stores only a valid key.
3. Connect context — Once the panel’s AgentTeams connection credential is configured, E2 uses the read-only tools bundled with the app to query the current project’s context directly. This E2 lookup does not need an external CLI. For E1, use the “AgentTeams MCP registration” detection flow to inspect external-agent MCP targets.
4. Run — Enter an instruction and press Run; output streams live. Only one run can be active at a time, and Cancel run stops it.

For the MCP server and its read-only tools, see MCP integration.

Prerequisites

• E1 requires Claude Code to be installed and signed in with a subscription account. The panel reports executable and configuration detection separately.
• E2 only requires an Anthropic API key. No external CLI installation or PATH setup is needed.
• Only E1 MCP target detection needs the agentteams CLI; see CLI install.

Current scope

• E1 supports Claude Code, and E2 supports the Anthropic Messages API.
• The app only detects MCP targets. Automatic apply remains unavailable until a secure credential helper can avoid copying the safeStorage key into an ordinary config file.
• Run history stays on this computer and is never uploaded to AgentTeams servers.
• The packaged E2 path is automatically checked with an empty PATH on macOS arm64 and Windows x64.

Platform notes

After changing macOS screen-recording permission, restart the app.

Install and updates

The app ships as a macOS .dmg and a Windows .exe. Install the released build for your platform; when a new version is available, the app prompts you to update.

Current caveats

• Capture depends on OS permissions and shortcut availability.
• Capture images are temporary and should not be treated as long-lived files.
• The desktop app does not replace the web app; it adds local capture and project-tab ergonomics around it.