Diff approval, live shell output, switching a panel's workspace folder, subagents with /steer, teams and /stats. Watch the full video, which also covers plan mode, stop and resume, and rewind.
## Features
- **Desktop app**: projects and chats in a sidebar, plus an editor with HTML preview, terminals, search and source control. See [Desktop app](docs/desktop-app.md).
- **Remote development**: SSH hosts, WSL distros and dev containers from the desktop app. See [Remote development](docs/remote-development.md).
- **GitHub and GitLab accounts**: sign in to github.com, gitlab.com and your own servers in the desktop app; git, CI status, links, history, cloning and publishing use each project's account. See [Git hosting accounts](docs/git-hosting.md).
- **Chat**: sidebar or editor panels with diff approval, live shell output, tool overlays, a prompt navigator and session history. See [Chat interface](docs/chat.md).
- **Context and cost**: a context ring, `/context`, `/usage` for subscription limits and `/stats` for spend across projects. See [Context stats](docs/chat.md#context-stats).
- **Models**: Anthropic, OpenAI, GitHub Copilot, StepFun, DeepSeek, MiniMax, xAI, Kimi Code and Meta models, picked per panel with per-model reasoning effort. See [Models](docs/models.md).
- **Agents and teams**: custom agent templates, background subagents, `/steer`, resume after an interruption, and teams of 2-5 specialists. See [Agents and teams](docs/agents.md).
- **Plan mode**: the agent writes a plan to a per-session file and waits for your approval before it changes anything. See [Plan mode](docs/plan-mode.md).
- **Design mode**: the agent designs in a linked design chat that writes only its design folder, checks each screen against your components and tokens, and sends you an approved version to plan against. See [Design mode](docs/design-mode.md).
- **Checkpoints and rewind**: roll back files, fork a conversation into a new panel, or rewind to before a compaction. See [Checkpoints](docs/checkpoints.md).
- **Compaction and caching**: manual and automatic compaction with per-model budgets, and prompt cache warming. See [Compaction](docs/compaction.md).
- **Permissions**: per-panel modes, YOLO, and allow, deny and ask rules compatible with Claude Code's settings files. See [Permissions](docs/permissions.md).
- **Hooks**: your own commands before and after tools, on prompt submit, on completion and when approval is needed. See [Hooks](docs/hooks.md).
- **Persistent memory**: facts, preferences, episodes and observations in SQLite, extracted automatically and injected when relevant. See [Persistent memory](docs/persistent-memory.md).
- **Compass**: an opt-in tree-sitter code graph with search, blast radius, review context and dead-code tools. See [Compass](docs/compass.md).
- **Browser**: a Patchright browser the agent drives, on by default and shown in editor tabs. See [Browser](docs/browser.md).
- **MCP**: servers from eight config sources, with per-tool exposure, resources, OAuth and elicitation. See [MCP servers](docs/mcp.md).
- **Web tools, image generation and GitHub and GitLab tools**: key-free web search and fetch, on by default, an opt-in `GenerateImage`, the agent's CI, merge request and issue tools on the desktop app, and deferred tool loading. See [Tools](docs/tools.md).
- **Mentions, commands and skills**: `@` files and agents, built-in and custom `/` commands, and skills from `.damocles`, `.claude` and `.codex`. See [Using Damocles](docs/usage.md).
- **Voice input**: push-to-talk cloud transcription or an on-device "Hey Jarvis" wake word. See [Voice input](docs/usage.md#voice-input).
- **Moved project folders**: the desktop app's Locate… moves a missing project's chats to its new folder, and VS Code offers to move a gone folder's chats into a clone or move of it you open. See [Desktop app](docs/desktop-app.md) and [Moved folders in VS Code](docs/usage.md#moved-folders-in-vs-code).
- **Localization**: the UI is in English and Greek. See [Localization](docs/configuration.md#localization).
## Requirements
- **Desktop app**: macOS 13 or later (Apple Silicon), Windows 10 or later, current 64-bit Linux distributions. See [Install the desktop app](#install-the-desktop-app)
- **VS Code extension**: VS Code 1.95.0 or higher
- For Claude models: a Claude subscription (Pro, Max, Team, Enterprise) **or** an `ANTHROPIC_API_KEY`. See [Authentication](#authentication)
- For GPT models: a ChatGPT subscription **or** an OpenAI API key
- For StepFun / DeepSeek / MiniMax / xAI / Kimi Code / Meta models: the respective provider API key or sign-in (set in their Settings panels)
- **Supported platforms**: Windows, macOS, and Linux. Memory and Compass use Node's built-in `node:sqlite` (no native modules or WASM), so there is nothing to compile per platform. Voice's wake-word mode and spoken replies run a separate Python sidecar on Windows x64, Linux x64 and macOS arm64 only (see the [voice guide](docs/voice-jarvis-mode.md))
## Installation
### Install the desktop app
Download the app from the assets of the [latest release](https://github.com/AizenvoltPrime/damocles/releases/latest). Supported systems are macOS 13 (Ventura) or later on Apple Silicon, Windows 10 or later, and current Linux distributions. Only 64-bit builds exist: x64 and arm64 on Windows and Linux, arm64 on macOS.
| System | Download | Install |
| --- | --- | --- |
| Windows x64 or arm64 | `Damocles-Setup-