CodeepCodeep
v2.5.0

Go Deep
into Code.

CODEEP

An autonomous AI agent that reads your whole project, runs commands, and writes & verifies code on its own — going deeper than autocomplete. Bring any model, hosted or local.

Get Started
Download for Mac1.0.5View on GitHubVS Code Extension2.5.0

Works with any model

ClaudeGeminiDeepSeekGLMOpenAIMiniMaxOllamaOpenRouter
50+Built-in skills
9+AI providers
30+Slash commands
FreeOpen source

How it works

From prompt to verified code

Codeep handles the full development loop autonomously — no context switching, no copy-pasting.

01

You describe the task

Type your request in plain language. No special syntax required. Codeep reads your project structure and key files automatically to understand the context.

input
~ $ > Refactor the auth module to use JWT tokens
02

Agent plans and executes

Codeep breaks the task into steps, executes them one by one — editing files, running commands, fetching documentation. You watch it work in real-time.

terminal
[1/4] Reading src/auth/
[2/4] Creating jwt.ts
[3/4] Updating middleware
[4/4] Running typecheck
03

Verified and ready

After making changes, Codeep runs your build, tests, or typecheck to verify everything works. If something breaks, it fixes it automatically.

output
✓ No type errors
✓ All tests pass
2 files created, 1 modified

Use cases

One command for every task

Codeep understands your codebase and executes real work — not just suggestions.

terminal
~$codeep fix the login form - validation isn't triggering on submit
▸
Scanning project — Reading src/components/LoginForm.tsx
▸
Identifying issue — Missing onSubmit handler — e.preventDefault() not called
▸
Applying fix — Patching LoginForm.tsx (2 lines)
▸
Verifying — ✓ Build passed · ✓ No type errors
✓ Fixed. The form handler was missing e.preventDefault(), causing the page to reload before validation ran.

Capabilities

Everything you need to code with AI

From autonomous agent tasks to git workflows — Codeep handles the full development loop from your terminal. Green “New” tags mark what shipped in 2.0.

Autonomous Agent

Reads files, runs shell commands, edits code, and auto-verifies the result (build / typecheck / tests) — all in one loop. You describe the goal; Codeep handles the steps.

File editsShell execAuto-verify
New

Sub-agents

Delegate a self-contained sub-task to a specialist that runs in its own fresh context and reports back — researcher, reviewer, tester, or your own. Keeps the main thread focused; optional auto-review after every change.

delegate/agentsAuto-review
New

Plan Mode

Preview the agent's full plan — files it'll touch, commands it'll run, risk it self-assesses — before any code changes. `/plan <task>` → review → `/go` to execute.

/plan/goPre-execution review

Full Project Context

Auto-scans your project structure, detects language and framework, reads key files. No manual context setup. Project memory + lifecycle hooks persist across sessions.

Auto-scan/memory.codeep/hooks/
New

Personalities

Switch agent tone mid-conversation: concise, verbose, security-paranoid, senior-reviewer, junior-mentor, ship-it. Or drop your own Markdown file in `.codeep/personalities/`.

6 presetsCustom .mdPer-project
New

User Profile

Tell Codeep how you like to work — reply language, response style, default stack, hard rules — and it adapts on every project and surface. Opt-in auto-learn picks up your preferences from sessions; sync across machines and the dashboard.

/meAuto-learnSynced

Git Workflows

AI review of your diff — bugs, security, performance, edge cases. Semantic commit messages. Works with any git repository. Hooks let you gate commits on custom checks.

/review/diff/commit
New

OpenRouter

100+ models from Anthropic, OpenAI, Google, Meta, DeepSeek, Mistral via one key. Authoritative cost from `usage.cost` — your dashboard sees the same numbers as your invoice.

100+ modelsReal per-call cost/openrouter
New

Prompt Caching

Automatic on Anthropic (and OpenRouter → Anthropic routes). Cache hits bill at 0.1× input rate; typical agent session is 60-90% cheaper. No config, just upgrade.

Anthropic60-90% cheaper/cost shows savings
New

MCP Marketplace

Curated catalog of 12 Model Context Protocol servers — filesystem, GitHub, Postgres, browser, Slack, more. One command install. Sampling guards keep credits safe.

12 serversstdio + HTTP/mcp install
New

Skill Marketplace

Write a SKILL.md (Markdown + YAML frontmatter), agent auto-invokes when triggers match. Publish to share — `/skills install <owner>/<slug>` from any machine. Claude Code-compatible.

SKILL.mdBrowse + publishAuto-invoke
New

VS Code & Zed (ACP)

Native agent inside VS Code and Zed via Agent Client Protocol. Same CLI binary, same commands, native diff viewer, image paste, manual confirmation mode.

VS CodeZedACP
New

Personal Dashboard

Link with `codeep account` to sync sessions, profiles, skills, and API keys across machines. Track cost-per-model, file bug reports, manage devices — all at codeep.dev.

Multi-device syncCost trackingBug reports

Secure & Local

API keys stored locally (encrypted at rest, synced encrypted if you opt in). Dangerous commands require confirmation. Full undo history. `/checkpoint` snapshots for safety.

Local keys/checkpoint/undo

MCP marketplace

One command, real integrations

Codeep speaks the Model Context Protocol — connect to your filesystem, GitHub, databases, browsers, Slack, anything that exposes an MCP server. Curated catalog, install with /mcp install <id>.

  • Filesystem

    Files & Code

    Read, list, and (optionally) write files in a sandbox directory.

    /mcp install filesystem

  • GitHub

    Files & Code

    Browse repositories, issues, PRs, and commits via the GitHub API.

    /mcp install github

  • PostgreSQL

    Database

    Read-only SQL access to a Postgres database — schema introspection + query.

    /mcp install postgres

  • Slack

    Communication

    Read channels, post messages, look up users and threads.

    /mcp install slack

  • Fetch (web)

    Web

    Fetch arbitrary URLs and return the markdown-converted contents.

    /mcp install fetch

  • Puppeteer (browser)

    Web

    Headless Chromium for navigating, screenshotting, and scraping pages.

    /mcp install puppeteer
Browse all 12 servers

Plus /mcp add for any custom server (npx, binary, or HTTP endpoint)

Skill marketplace

Skills that travel with you

Drop a SKILL.md in .codeep/skills/ and the agent auto-invokes it when triggers match. Publish to share — install on any machine with one command. Claude Code-compatible format.

  • sharepoint-spfxv1.0.0
    0

    Build, debug, package and deploy SharePoint Framework (SPFx) web parts, extensions and apps for SharePoint Online and Microsoft Teams.

    VladoIvankovicinstalls
    /skills install VladoIvankovic/sharepoint-spfx
Browse marketplace

Or write your first skill — Markdown + YAML frontmatter, ~5 minutes

Installation

Up and running
in 30 seconds

Choose your preferred install method. Codeep runs on macOS, Linux, and Windows (WSL). No configuration required — just run codeep to start.

✓
Node.js 20 or later
✓
Any terminal (zsh, bash, fish, PowerShell)
✓
API key for your preferred AI provider
# One-line installer (macOS / Linux)
$ curl -fsSL https://raw.githubusercontent.com/VladoIvankovic/Codeep/main/install.sh | bash

AI Providers

Use any LLM you want

Codeep works with all major AI providers. Switch between them at any time from the settings menu. Your keys are stored securely on your machine.

Anthropic

Claude models — Opus, Sonnet, Haiku

OpusSonnetHaiku

DeepSeek

Pro and Flash models

ProFlash

Google AI

Gemini Pro and Flash models

Gemini ProGemini Flash

MiniMax

Coding plan and pay-per-use

MiniMax M

Ollama (Local AI)

Run models locally or on a remote server — no API key required

Any installed modelLlamaQwen Coder

OpenAI

GPT models — flagship, Mini, Nano

GPTGPT MiniGPT Nano

OpenRouter

One key, 100+ models from every major provider

100+ modelsopenrouter/auto

Z.AI

Coding plan and pay-per-use

GLMGLM Turbo

All providers use the OpenAI-compatible API format or Anthropic protocol. Switch anytime with /settings

Native app

Codeep for Mac

A first-class native desktop app — the same agent as the CLI, with a chat window, a project sidebar, inline diffs, and a real Settings pane. Built in SwiftUI, not an Electron wrapper.

  • Runs the full agent locally — shell, git, file edits
  • Project sidebar with inline diffs and tool confirmations
  • Every provider — Anthropic, OpenAI, Z.AI, MiniMax, Gemini, Ollama…
  • Keys in the iCloud Keychain; syncs with the CLI & dashboard
  • Auto-updates via Sparkle; Spotlight & Shortcuts built in
Get Codeep for Mac
Codeep — the native Mac app
New

Native Zed Editor integration

Codeep runs as a native AI agent inside Zed via the Agent Client Protocol (ACP). Use all 30+ Codeep commands directly from the Zed chat panel.

  • Full slash command support in Zed chat
  • Live tool call display as agent works
  • Thinking indicators during reasoning
  • File edit notifications in real-time
~/.config/zed/settings.json
// 1. Install Codeep
$ npm install -g codeep
 
// 2. Add to Zed settings
"agent_servers": {
"Codeep": {
"type": "custom",
"command": "codeep",
"args": ["acp"]
}
}
 
// 3. Open Zed AI panel → select Codeep → /help
New

VS Code extension

Codeep is now available as a VS Code extension. Get the full AI coding agent experience directly in your editor — no terminal required.

  • Chat sidebar with streaming responses
  • Live agent plan — watch multi-step tasks update in real time
  • Session browser — load and resume past conversations
  • Inline permission prompts with diff preview before Allow
  • Settings panel — switch model, provider, and mode
  • @file mentions — type @ to attach any workspace file
  • Send selected code or review any file from the editor
Install from Marketplace
VS Code
// Option 1 — install from terminal
$ code --install-extension VladoIvankovic.codeep
 
// Option 2 — search in Extensions panel
Cmd+Shift+X → search "Codeep"
 
// Open chat
Cmd+Shift+C or click the ⟨⟩ icon
 
// Requires Codeep CLI
$ npm install -g codeep

Releases

Shipping fast

RSSAll releases →

FAQ

Common questions

Don't see yours? Ask on the dashboard or start a discussion.

  • Is my code sent to a third party?
    Only to the LLM provider you choose, only when you invoke the agent. Codeep is a thin client over your API key — file contents, prompts, and tool calls go straight to Anthropic / OpenAI / Z.AI / OpenRouter / etc. We don't proxy anything through codeep.dev. The optional dashboard sync (opt-in via codeep account) uploads session metadata and learning preferences only — never raw code. Privacy details.
  • Does it work offline?
    Yes — pick ollama as your provider. Codeep talks to a local Ollama daemon, so no network call leaves your machine. Tool calls (read/write files, run commands) are unchanged. Smaller local models are slower at multi-step reasoning, so set /settings → Max Iterations higher and expect more back-and-forth. Provider docs.
  • What does it cost?
    Codeep itself is free + open source (Apache 2.0). You pay your LLM provider directly. For OpenRouter, Codeep shows the exact usage.cost from each response on your dashboard. Prompt caching (default on Anthropic)typically reduces a session bill by 60-90%. For Z.AI on the GLM Coding Plan, it's flat-rate. How caching works.
  • Which model should I use?
    For coding: Claude Opus 4.8 (Anthropic) or GPT-5.5 are the strongest. For cost-per-token: DeepSeek V4 Pro or GLM-5.1 are 5-10× cheaper with little quality drop on typical tasks. For local: Llama 3.1 70B via Ollama (needs 24GB+ VRAM). Or set provider to openrouter and model openrouter/auto — the router picks for you per request. Provider matrix.
  • How does it compare to Cursor / Claude Code / Aider?
    Codeep is terminal-native (TUI + ACP for Zed / VS Code), multi-provider by design, and open-source. Cursor is a fork of VS Code locked to its own backend. Claude Code is Anthropic-only and closed-source. Aider is terminal-native too but doesn't do ACP or skill bundles. If you want one tool that works the same across CLI, Zed, and VS Code with any provider — Codeep's the bet.
  • Can I use my own LLM endpoint?
    Yes — for any OpenAI-compatible endpoint, pick ollama provider and set /settings → Ollama URL to your endpoint. Authentication header is configurable. Self-hosted vLLM, LM Studio, or any inference server that speaks OpenAI's /v1/chat/completions works.
  • What's MCP and why should I care?
    Model Context Protocol — the emerging standard for letting LLMs talk to external systems. Codeep supports it end-to-end: connect a Postgres server, GitHub, browser automation, Slack, anything that speaks MCP. Browse 12 curated servers on the marketplace or add custom ones with /mcp add.
  • Do I need to log in to codeep.dev?
    No — Codeep works fully offline with just an LLM key. The optional account (free, GitHub OAuth) syncs session history, profiles, and learning preferences across machines, and unlocks the skill marketplace publish flow. Everything is opt-in. Account docs.

Open Source

Start coding with AI today

Free and open source. Works with your existing AI provider subscriptions. No account required to get started.

Read the docs
Star on GitHubFollow on XFollow on Bluesky