A native desktop GUI for GitHub Copilot, built on the Copilot SDK.
Overview
A native desktop GUI for GitHub Copilot, built on the Copilot SDK. - - A subscription - installed and authenticated — run gh auth login if you haven't already This installs dependencies, runs tests, builds the app, and packages it. The output goes to the release/ directory: Run pwsh -NoProfile -File .\scripts\setup-windows.ps1 before npm run dist to set up build dependencies. Run sudo ./scripts/install-linux-deps.sh before npm run dist to install native dependencies. - 🗂️ — Multiple conversations, each with its own working directory and model - 🌳 — Paste a GitHub issue URL → isolated worktree + session - 🔁 — Iterative agent mode: set completion criteria, let it loop until done - 💻 — Real PTY per session, one click to attach output to your prompt - 🎤 — Speech-to-text and text-to-speech - 🔌 — Model Context Protocol for extended tool capabilities - 🎯 — Personal and project skills via SKILL.md, .agent.md, and subagent delegation - 🤖 — Dynamic model list with favorites — GPT-5.
README
Cooper
A native desktop GUI for GitHub Copilot, built on the Copilot SDK.
Prerequisites
- Node.js 22+
- A GitHub Copilot subscription
- GitHub CLI installed and authenticated — run
gh auth loginif you haven’t already
Installation
Clone the repo, then:
npm run dist
This installs dependencies, runs tests, builds the app, and packages it. The output goes to the release/ directory:
| Platform | Output |
|---|---|
| macOS | release/Cooper--mac-arm64.dmg |
| Windows | release/Cooper--win-x64-Setup.exe |
| Linux | release/Cooper--linux-x64.AppImage |
Windows: Run
pwsh -NoProfile -File .\scripts\setup-windows.ps1beforenpm run distto set up build dependencies.Linux: Run
sudo ./scripts/install-linux-deps.shbeforenpm run distto install native dependencies.
Features
- 🗂️ Tabbed Sessions — Multiple conversations, each with its own working directory and model
- 🌳 Git Worktree Sessions — Paste a GitHub issue URL → isolated worktree + session
- 🔁 Ralph Wiggum — Iterative agent mode: set completion criteria, let it loop until done
- 💻 Embedded Terminal — Real PTY per session, one click to attach output to your prompt
- 🎤 Voice Input/Output — Speech-to-text and text-to-speech
- 🔌 MCP Servers — Model Context Protocol for extended tool capabilities
- 🎯 Agent Skills & Subagents — Personal and project skills via
SKILL.md,.agent.md, and subagent delegation - 🤖 Model Selection — Dynamic model list with favorites — GPT-5.2, Opus-4.6, Sonnet, Haiku, Gemini, and more
- ⚡ YOLO Mode — Auto-approve tool calls for uninterrupted agent flow
Development
npm install && npm run dev
See CONTRIBUTING.md for details.
Community
Join our Discord to report bugs, request features, and chat.
License
MIT
Recommended Tools
Try a different keyword or remove a filter.
Install
npx skillfish add cooperagent/cooper