Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 15 additions & 23 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,40 +13,31 @@ A native desktop GUI for GitHub Copilot, built on the [Copilot SDK](https://gith
- A **[GitHub Copilot](https://github.com/features/copilot)** subscription
- **[GitHub CLI](https://cli.github.com/)** installed and authenticated — run `gh auth login` if you haven't already

## Install
## Installation

### Windows
Download the latest release from the **[Releases page](https://github.com/CooperAgent/cooper/releases/latest)**:

Download the latest `.exe` from the **[Releases page](https://github.com/CooperAgent/cooper/releases/latest)** and run it.
| Platform | File | Notes |
|----------|------|-------|
| **macOS** (Apple Silicon) | `Cooper-<version>-mac-arm64.dmg` | Signed and notarized |
| **Windows** (x64) | `Cooper-<version>-win-x64-Setup.exe` | Installer |
| **Windows** (x64) | `Cooper-<version>-win-x64-Portable.exe` | No install needed — just run it |

### macOS
<details>
<summary><b>Build from source</b></summary>

Requires **Node.js 22+**.

**macOS:**
```bash
git clone https://github.com/CooperAgent/cooper.git && cd cooper && npm install && npm run dist && open release/Cooper-*-arm64.dmg
git clone https://github.com/CooperAgent/cooper.git && cd cooper && npm install && npm run dist
```

<details>
<summary><b>Build from source on Windows</b></summary>

If you prefer building from source instead of using the installer:

**Windows:**
```powershell
git clone https://github.com/CooperAgent/cooper.git; cd cooper; pwsh -NoProfile -File .\scripts\setup-windows.ps1; npm run dist:win
```

The setup script installs all Windows-specific prerequisites (Python, VS Build Tools, PowerShell 7+) and npm dependencies automatically.

</details>

<details>
<summary><b>Using an AI coding agent to install</b></summary>

Tell your agent:

> Clone `https://github.com/CooperAgent/cooper.git`, install dependencies, and build an installer for my OS (macOS → `.dmg`, Windows → `.exe`).

</details>

## Features
Expand All @@ -57,8 +48,9 @@ Tell your agent:
- 💻 **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** — Personal and project skills via `SKILL.md` and `.agent.md` files
- 🤖 **Model Selection** — GPT-5.2, Opus-4.6, Sonnet, Haiku, Gemini, and more
- 🎯 **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

Expand Down
36 changes: 36 additions & 0 deletions RELEASE_NOTES.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,42 @@ All notable changes to Cooper will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## 1.0.1

### Added

- **Downloadable Executables** — Pre-built macOS `.dmg` and Windows `.exe` installers (Setup + Portable) on every release
- **Subagent Visibility** — See active subagents in the environment panel with file preview support
- **YOLO Mode** — Auto-approve all permission requests for uninterrupted agent flow
- **Drag & Drop Sessions** — Reorder tabs by dragging them
- **Favorite Models** — Pin your preferred models for quick switching; dynamic model list fetched from API
- **Copilot Instructions** — `.github/copilot-instructions.md` support with IPC and state management
- **Environment Panel** — View agent files, skills directories, and Copilot instructions from a dedicated panel
- **Zoom Controls** — Persistent window zoom in/out via keyboard shortcuts
- **Copy CWD** — One-click copy of the current working directory with visual feedback
- **Electron Startup Test** — Automated test verifying the app launches without module errors
- **Skills Documentation** — Comprehensive skills index and individual skill docs

### Changed

- **Windows Native Title Bar** — Windows builds use native title bar overlay for a platform-native look
- Dynamic model list from API replaces hardcoded model dropdown
- Restructured app folder layout — components moved out of monolithic `App.tsx`
- Sidebar drawer labels updated; top-bar model selector removed in favor of in-session switching
- Terminal toggle moved to a dedicated button
- Removed Microsoft Clarity telemetry
- Removed session keep-alive logic
- Updated instructions discovery to match Copilot CLI SDK conventions

### Fixed

- Model switching in new sessions no longer resets to default
- Terminal open state persists correctly when switching tabs
- Agent names display instead of file paths in the environment panel
- Markdown files without frontmatter no longer cause agent parsing errors
- File preview tree view padding alignment
- Tour highlight targeting for agent modes selector

## 1.0.0

Cooper is a fresh start — a rebrand and ground-up evolution of what was previously Copilot Skins. This release marks the first official version under the new name.
Expand Down