A desktop workspace for Copilot-powered work across real projects.
Aryx is a desktop app that turns GitHub Copilot into a full workspace. Connect real projects, orchestrate multi-agent workflows, and keep persistent sessions organized — instead of starting from scratch in a blank chat window every time. It runs on Windows, macOS, and Linux.
- Multi-agent orchestration — single, sequential, concurrent, handoff, and group-chat patterns with a visual graph editor, reusable workflow templates, and workflow import/export.
- Project-grounded — attach local folders and repos so every conversation has real codebase context.
- Live execution visibility — watch agents think, delegate, call tools, and consume context in real time.
- Persistent workspace — sessions survive restarts. Search, pin, archive, branch, and return to past work.
- Extensible tooling — MCP servers, LSP profiles, project hooks, and fine-grained tool approval controls.
- Keyboard-first — command palette, rich shortcuts, mid-turn steering, and a built-in terminal.
- Launch Aryx — the app checks your Copilot CLI connection and shows status on the home screen.
- Connect a project or open a scratchpad for quick questions without any setup.
- Pick a pattern — choose a single-agent chat or a saved multi-agent orchestration workflow.
- Work — ask questions, steer agents mid-turn, watch live activity, and keep the session for later.
| Feature | Description |
|---|---|
| Scratchpad sessions | Quick questions with isolated working directories — no project setup needed |
| Persistent sessions | Rename, pin, archive, duplicate, and return to sessions across restarts |
| Session branching | Fork a session at any user message to explore a different direction |
| Session search | Full-text search across all session messages, not just titles |
| Message actions | Copy, pin, edit-and-resend, and regenerate individual messages |
| Bookmarks | Browse all pinned messages across sessions in one panel (Ctrl+Shift+B) |
| System tray | Minimize to tray, quick-launch scratchpads, and see running session count |
| Quick Prompt | System-wide hotkey (Win+Shift+A / Cmd+Shift+A) summons a floating popup for instant AI questions from any app |
| Desktop notifications | Native OS alerts when runs complete, fail, or need approval |
| Onboarding | First-launch walkthrough, interactive tooltips, and a "try it" quickstart |
| Feature | Description |
|---|---|
| Orchestration patterns | Single, sequential, concurrent, handoff, and group-chat agent flows |
| Workflow templates | Save workflows as reusable templates, bootstrap from built-ins, and upgrade patterns into workflows |
| Workflow import/export | Export workflows as YAML, Mermaid, or DOT and import normalized definitions from YAML or JSON |
| Visual pattern editor | Drag nodes, draw connections, and inspect each step in a graph view |
| Mid-turn steering | Send follow-up messages while an agent is running — input is injected immediately |
| Plan review & questions | Agents propose plans and ask clarifying questions before acting |
| Run timeline | Structured history of tool calls, delegations, hooks, and context usage |
| Copilot customization | Auto-discovers repo instructions (copilot-instructions.md, AGENTS.md, CLAUDE.md, .instructions.md, .claude/rules), agent profiles, and prompt files across nested repo roots, expands Markdown-linked context, exposes prompt metadata (tools, model, argument-hint), then auto-rescans when those files change |
| Model & effort tuning | Choose models, adjust reasoning effort, and set interaction modes per session |
| Feature | Description |
|---|---|
| Real project context | Attach folders and repos — see branch, dirty state, and ahead/behind status |
| MCP servers | Define servers globally, enable per session, auto-discover from project configs |
| LSP profiles | Language server integration for code intelligence in agent workflows |
| Tool approval | Fine-grained approval policies with pattern-level defaults and per-session overrides |
| Project hooks | Auto-discovers .github/hooks/*.json and runs lifecycle hooks in the sidecar |
| Image input | Attach screenshots, diagrams, or photos for visual reasoning |
| Integrated terminal | Full PTY-backed terminal inside the workspace (`Ctrl+``) |
| Command palette | Ctrl+K fuzzy search across actions, sessions, and settings |
| Keyboard shortcuts | Comprehensive keybindings with a cheat sheet via Ctrl+/ |
- GitHub Copilot CLI installed and available as
copilot - An active GitHub Copilot sign-in
- Windows, macOS, or Linux
Aryx shows your Copilot connection status in the app so you know if authentication is ready before starting a session.
bun run test # typecheck + unit tests
bun run sidecar:test # backend tests
bun run build # full build (electron + sidecar)
bun run aspire # start the standalone Aspire Dashboard in Docker
bun run dev:otel # start Aspire + Aryx dev with OTLP export enabled
bun run package # package for current platform → release/
bun run installer # create installable artifact
bun run publish-release # publish to GitHub Releases
bun run release # bump patch version, commit, tag, and push
bun run release minor # bump minor version instead (use major for breaking releases)For local observability, bun run dev:otel starts the Aspire Dashboard UI at http://localhost:18888
and configures the sidecar to export OpenTelemetry traces to http://localhost:4317 over OTLP/gRPC.
This dev workflow requires Docker.
Tagged releases use GitHub Actions to build and publish Windows (NSIS), macOS (DMG, signed + notarized), and Linux (AppImage) artifacts. The app uses electron-updater for in-app updates.
The release helper expects a clean git worktree, an upstream branch configured for the current branch, and permission to push commits and tags.
GitHub and GitHub Copilot are trademarks of Microsoft Corporation. Aryx is an independent project, not affiliated with or endorsed by Microsoft or GitHub.