The native Mac app for running Pi coding agents with clarity and control.
Agent Deck uses your installed Pi CLI and gives its sessions, resources, and parallel work a calm, visible home.
Download for Mac · Documentation · Issues
Pi is the coding agent. Agent Deck is the native macOS workspace around it — not a replacement runtime and not a web wrapper. It launches the Pi you already have in JSONL RPC mode and makes the surrounding work easier to understand and safer to manage.
- You can see what is active. Agents, skills, prompts, and commands show their scope and are assigned deliberately. A file sitting on disk does not silently become part of a session.
- You can see what will change. Built-in resources stay read-only, customizations use overrides, and write targets are shown before work begins. Report-only subagents write to their own artifacts, not your project.
- Parallel work stays organized. Give sessions and subagents isolated git worktrees, follow their status in one place, and merge work back when you choose.
- It feels like a Mac app. SwiftUI windows, keyboard shortcuts, native decision prompts, signed and notarized releases — with no Electron or embedded web UI.
- Run Pi sessions with content-hugging message cards, a live transcript, tool calls, plans, file previews, steering messages, attachments, terminal handoff, and session-scoped composer drafts that survive switching sessions until the app closes.
- Organize agents, skills, reusable prompts, and slash commands for a project or across projects.
- Delegate research, planning, implementation, or review to app-managed subagents and track their results.
- Start from a GitHub issue, work in an isolated branch and worktree, then review, commit, push, or merge the result.
- Browse available models and providers, set session or agent preferences, and manage global environment keys with secret masking.
- Keep project-specific Markdown memory for decisions and runbooks, with secret scanning on memory writes.
- Use Doctor and onboarding to find, install, and update Pi.
Install Pi if needed, then download, verify, and copy Agent Deck to /Applications:
curl -fsSL https://raw.githubusercontent.com/a-streetcoder/agent-deck/main/install.sh | bashThe script is install.sh; read it and its history before piping it to your shell.
Or download the latest signed and notarized DMG and drag Agent Deck to /Applications. If Pi is not installed, onboarding can install it for you. App updates use Sparkle and appear as normal macOS update dialogs.
Requires macOS 26 (Tahoe) and Apple Silicon.
The detailed reference is in agent-deck-documentation/:
- What Pi provides and what Agent Deck adds
- Resource scopes and assignment
- Safety, write targets, and artifacts
- System prompt and Pi launch logic
- Skills, memory, and model & thinking settings
Agent Deck tracks one essential, privacy-minimized app_opened event per production app launch to improve the product. Agent Deck does not add prompts, responses, code or file contents, project or repository names or paths, account identifiers, credentials, screenshots, tool/MCP data, raw errors, or other PII to analytics events. PostHog is EU-hosted at https://eu.i.posthog.com; like any network service, it receives the request IP and may use it to derive country-level geography.
The integration is disabled in Debug builds, XCTest, SwiftUI previews, AutoPerf, and benchmarks. It does not create person profiles or app-authored identities, and it disables automatic lifecycle capture, screen views, swizzling, error tracking, and feature-flag preloading.
git clone https://github.com/a-streetcoder/agent-deck.git
cd agent-deck
open agent-deck.xcodeprojBuild the agent-deck scheme with Xcode 26.4+, or run:
xcodebuild -project agent-deck.xcodeproj -scheme agent-deck \
-configuration Debug -destination 'platform=macOS' \
CODE_SIGNING_ALLOWED=NO buildMIT License. See LICENSE.