Installation

Codeep runs on macOS, Linux, and Windows (via WSL). It requires Node.js 20 or later. Choose the install method that works best for you.

The redesigned Codeep terminal UI with agent timeline, changed files, checks, and resource estimates — Codeep in the terminal — Plan, Read, Edit, Verify, and Summary remain visible while the agent works

Requirements

✓Node.js 20 or later
✓npm 9 or later (included with Node.js)
✓Terminal: zsh, bash, fish, or PowerShell
✓API key for at least one supported AI provider

Option 1: npm (Recommended)

# Install globally
$ npm install -g codeep
 
# Verify installation
$ codeep --version
3.1.1

Option 2: curl

One-line installer for macOS and Linux, for a machine without Node:

$ curl -fsSL https://codeep.dev/install.sh | bash

The install script detects your platform, installs the latest version, and verifies the installation. It is served from this domain and fetched from the newest release on GitHub, so the command stays the same wherever the repository lives.

Updating

$ npm update -g codeep

First run

After installation, navigate to your project folder and run:

$ cd your-project
$ codeep

On first launch, Codeep will ask you to select an AI provider and enter your API key. The key is stored securely in your system keychain.

★

You can set your API key via environment variable to skip the prompt:
export ANTHROPIC_API_KEY=sk-...

Introduction Quick Start