docs
browse docs
on this page

Start here

your agents. one window

ködade is a desktop Agentic Development Environment. It brings agent chats, project folders, real terminal sessions, files, and the agent CLIs you already use into one workspace. It opens on the tabbed workspace — Agents, Code, and Editor tabs over one persistent sidebar — with the classic 1.x layout one click away for one more release.

ködade is open source under Apache License 2.0. The macOS app is available now from GitHub Releases. Windows has no current release package, and Linux is planned.

Begin with a project

  1. Download the macOS DMG.
  2. Follow Your first project to add a folder and reach a working agent or terminal prompt.
  3. Start a KödChat thread with Claude Code or Codex, or run any supported agent CLI in a terminal.

Adding a project opens an initial terminal at that folder's root. Your normal login-shell startup, prompt, and PATH apply. ködade does not proxy the shell or sign in to agent providers for you.

Learn the core workflow

  • Projects and workspace layout explains project switching, the tabbed workspace and the classic-layout escape hatch, sidebar modes, colors, and local persistence.
  • KödChat covers provider, model, access, attachments, and local transcript storage.
  • Terminal sessions covers creating, naming, switching, closing, and dropping paths into terminals.
  • Agent CLIs explains installation detection, version reporting, authentication boundaries, chat support, and manual launch.

Beyond the core workspace

  • Agents tab builds reusable agent personas and prepares runs from them as KödWork background tasks.
  • Connections attach MCP servers to a persona from a curated catalog or a custom server, bring-your-own-key and reviewed on install.
  • KödWork runs durable background tasks and holds their progress, permission requests, and file output for review.
  • KödHarness installs skills and merges MCP servers through reviewed, preview-then-apply changes.
  • Köd Workspace and KödMem keep activity and durable project memory visible and local.
  • KödMCP gives agent tools controlled access to KödMem.

What survives a restart

ködade stores your projects, KödChat transcripts, and selected UI metadata locally. Project colors, pane layouts, theme, sidebar mode, chat threads, and open-tab metadata can return after a restart. Live terminal processes and unsaved editor buffers do not.

That boundary matters: save editor changes and finish or stop terminal work before quitting the app.