Devia Desktop Documentation

What is Devia Desktop?

Devia Desktop is a desktop application for developing software with AI agents. It is a friendly, unified interface over multiple agentic CLI tools (Claude Code, Codex, Gemini CLI, and more) that turns working with terminal agents into a visual, organized, multi-project experience.

It is FreeWare: free with 100% of features included, available for Windows, macOS, and Linux. Everything runs locally, on top of your projects and your CLIs — no account or connection to any external service required.

Installation

Windows

1. Download the .exe installer from the downloads page.
2. Run it and choose the installation directory (per-user installation, no administrator privileges needed).
3. If SmartScreen shows a warning, click "More info → Run anyway".

macOS

1. Download the .dmg for your architecture (Apple Silicon or Intel).
2. Open it and drag Devia into the Applications folder.
3. The app is signed and notarized by Apple: it opens with no additional steps.

Linux

1. AppImage: download it, make it executable with chmod +x Devia-*.AppImage, and run it.
2. Debian/Ubuntu: install the package with sudo dpkg -i devia_*_amd64.deb.

Getting started

1. Choose your workspace. The first time you open Devia, a modal asks for the root folder where your projects live (for example, ~/repos). Devia lists the projects it finds and detects their technology stack.
2. Connect an agent. Devia detects the agentic CLIs installed on your machine and lets you choose the active agent in Settings. Each project is configured so the agent works with no manual adjustments.
3. Chat. Open a project and type your first instruction in the composer. Choose the execution mode — plan (plan only), apply (apply with permissions), or apply-yolo (no confirmations) — depending on how much autonomy you want to grant.
4. Review. Each response streams in with markdown, tool calls expand into cards, and the agent's changes appear as inline diffs.

Supported agents

Devia works with the following coding CLIs, and you can switch between them without leaving the app:

When continuing a session with a different agent than the one that started it, Devia performs an automatic context handoff: it injects a summary of the work (goal, files touched, and recent exchanges) into the new agent's first turn and places a divider in the chat.

Features

Multi-project and sessions

• List, create (blank or from a template), and clone projects; pin favorites to the sidebar.
• Per-project session history that survives restarts; resume or restart a session with one click.
• Instruction queue: queue prompts while the agent is busy, reorder with drag and drop, pause and resume.

Multi-session split view

• Up to 4 panels (2×2) in the same window, each with its own session and its agent working in parallel.
• Each additional panel works isolated in its own git worktree (a new branch from the main branch) so two agents never step on the same files.
• The split and its worktrees survive app restarts, restoring each session's files.

Kanban with built-in SDD

• Per-project Kanban board with specs, tasks, and dependencies.
• The agent itself reads and updates the board via MCP (devia-kanban): end-to-end spec-driven development workflow.
• Board state lives outside the repository, in Devia's data folder.

Persistent memory

• Cross-session memory (devia-memory) scoped personally and per project.
• The agent queries and feeds it automatically: decisions, resolved bugs, and discoveries are all recorded.
• Management panel in Settings: search, pin, forget, or clear observations.

Built-in Git

• Live repository status in the sidebar.
• Change viewer with inline comments: annotate diff lines and send them to the agent as a review request.
• Worktree support and snapshots with rollback before destructive operations.

MCP servers, skills, and prompts

• Model Context Protocol server manager: install, enable, test, and share servers across agents; Devia injects the configuration in each CLI's native format.
• Discover and install local or GitHub-hosted skills.
• Prompt packs: per-project system prompt packages.
• Reusable multi-CLI sub-agent manager, shared across projects.

Remote control via Telegram

• Launch runs, check status (branch, context used, cost), and chat with the agent from Telegram.
• Optional mirroring of the desktop conversation and forwarding of attachments (photos, documents) to the agent.

Terminal, voice, and more

• Per-project integrated terminal with a real PTY, and open-in-your-favorite-IDE support.
• Docker Compose orchestration: deploy, down, and logs per project.
• Local voice transcription with Whisper — audio never leaves your machine.
• Drag-and-drop image attachments for multimodal models.
• Project file browser in the right rail and an archive of files generated by the agent (outbox).
• Audit log of every tool-call with rotation and a 30-day retention policy.
• 11 languages (es, en, ca, fr, de, it, pt, ru, zh, hi, ar), 8 Material 3 accent palettes, and adjustable font size.

Configuration and data

All Devia data lives on your disk, under ~/.devia-app/ (on Windows, C:\Users\<tu-usuario>\.devia-app\):

To back up your Devia data, simply copy that folder. Deleting it resets the app to its initial state.

Updates

Published versions are announced in this site's public manifest: updates/latest.json. It contains the latest available version, the release date, release notes, and download links per platform.

Devia Desktop checks that manifest to notify you when a new version is available. You can also check it manually or from your own scripts:

curl -s https://dherrero.github.io/devia/updates/latest.json | jq .version

FAQ

Is Devia free?

Yes. Devia Desktop is FreeWare with 100% of features included, on all platforms.

Do I need an account or a connection to any Devia service?

No. Devia Desktop works entirely locally. The only external services used are those of the CLI agents you have configured yourself.

Does Devia include the AI agents?

No — Devia is the interface that directs them. You need at least one agentic CLI installed (Claude Code, Codex, Gemini CLI, OpenCode…) with its credentials. Devia detects them and takes care of the rest.

Does my data leave my machine?

No. Sessions, memory, Kanban boards, and configuration all live in ~/.devia-app/. Voice transcription with Whisper also runs locally. The only thing that travels is what the CLI agent you use sends to its own provider.

What languages are available?

Spanish, English, Valencian, French, German, Italian, Portuguese, Russian, Chinese, Hindi, and Arabic.

How do I report an issue?

Open an issue in the Devia GitHub repository with the steps to reproduce it and your platform (Windows/macOS/Linux).