Install

AgentDesk is a self-contained desktop app. Download the latest release for your platform — no separate runtime to install.

Download

Get the latest build from github.com/biskilled/agentdesk-releases:

Platform	File
macOS (Apple Silicon)	*-arm64.dmg
macOS (Intel)	*.dmg
Windows	AgentDesk-Setup-*.exe
Linux	*.AppImage

Auto-detect

The download page on biskilled.com detects your OS and offers the right build automatically.

Install

• macOS — open the .dmg and drag AgentDesk to Applications. On first launch, approve it in System Settings → Privacy & Security if Gatekeeper prompts.
• Windows — run the Setup installer (you can choose the install directory).
• Linux — make the .AppImage executable (chmod +x AgentDesk-*.AppImage) and run it.

First run

On first launch AgentDesk:

1. Creates a workspace for your projects (per-client, isolated).
2. Detects your AI CLIs — it searches your PATH for claude, codex and gemini. If a CLI is missing and you want it, AgentDesk offers a one-click install. These CLIs are optional — the app and its skills work without them.
3. Asks for at least one provider key — see Models & keys. You bring your own; you only pay your provider for usage.

Storage & data

• App logs live under ~/.agentdesk/logs/.
• Project files and session state live in your AgentDesk workspace directory.
• Memory is stored in PostgreSQL + pgvector when a database is configured (recommended, enables semantic search). Without one, AgentDesk falls back to local file-based capture.

Optional: connect a database for full memory

Semantic search across your project memory needs PostgreSQL with the pgvector extension. Point AgentDesk at it via a DATABASE_URL, and the Events and Work-Item layers become searchable. Without a database, raw capture still works but semantic recall is limited.

Updating

AgentDesk checks for new releases and points you to the latest build. To update manually, download the newest file from the releases page and reinstall.

Next: Memory model →