Skip to main content

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:

PlatformFile
macOS (Apple Silicon)*-arm64.dmg
macOS (Intel)*.dmg
WindowsAgentDesk-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/.
  • AgentDesk's internal project state lives under .agentdesk/workspace/{project}/.
  • Editable use-case Markdown lives in your configured documents folder under use_cases/.
  • The generated .okf/ knowledge bundle lives beside use_cases/ and can be committed with the project so every tool sees the same concise context.
  • 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.

Refreshing an existing project​

Project creation installs the selected CLI integrations, hooks and skills. If you add a CLI later, move the project, or suspect a hook is missing, open the project's Settings and use the integration refresh/repair action. AgentDesk checks Claude Code, Codex and Gemini independently and rewrites only the managed configuration.

Next: Memory model →