Start

Overview

Codey is a local-first AI workspace that edits code in your terminal, desktop app, and editor.

#Workspace

Terminal TUI: the main interface, launched with codey in any project directory. Desktop app: the same sessions with a graphical window on macOS and Windows.

Start a session from any project directory with the terminal invocation below.

bash

cd ~/projects/my-app && codey

Session opens: Codey reads the directory and waits for your first instruction.
State stays local: files, keys, and history remain on your machine.

#Models and skills

200+ providers: bring your own key and switch models mid-task.
Free models: a no-key route in the picker, so a fresh install runs before you connect anything.
25 local CLIs: the agent CLIs you already use run inside Codey, auto-detected and streamed.
70+ skills: packaged workflows Codey loads on demand.

#Tools

An agent with hands returns finished work, not a description of it.

Browser: a managed Chromium in the side panel that you and the agent drive as one. Pro.
Design systems: 34 design languages an artifact is bound to by token contract. Pro.
Document tools: Docs, Sheets, PDF, Writer, and Slides built in; local files, Office documents, and video open inside Codey.
Your own: custom tools in TypeScript, any MCP server, and every bridged capability handed to the local CLIs.

#Agents

Athena: plans the work before anything is written.
Prometheus: implements the plan in code.
Iris: executes delegated subtasks in isolated sessions.
Scout: researches codebases and external sources.
Matis: builds full applications in Autopilot mode.
Hermes: runs delegated office work in Workpilot mode.

#Modes

Co-Pilot: you direct, Codey edits with your approval.
Autopilot: Codey plans and builds with less supervision.
Workpilot: Codey handles delegated tasks outside the editor.