代码智能助手

Installation

deploy-staging

Run the test suite, build, then npm run deploy:staging. If the build fails, surface the error and stop — don't deploy a broken build. ```

The agent gets the bundle catalog injected into its system prompt on every iteration and can invoke any bundle via the invoke_skill tool:

• /skills bundles — list installed bundles
• /skills create-bundle <name> — scaffold a new project skill
• /skills show <name> — print the SKILL.md
• /skills browse [query] — search the public marketplace
• /skills install <owner>/<slug> — pull from marketplace
• /skills publish <name> [--public] — share to codeep.dev
• /skills unpublish <owner>/<slug> — remove your published skill

Web marketplace: publish skills to codeep.dev/skills as public (browseable by anyone) or private (only you). Manage your published skills at /dashboard/skills. From the VS Code extension, use the Codeep: Browse Skill Bundles… / Codeep: Create Skill Bundle… / Codeep: Open Skills Folder commands.

Example for macOS Apple Silicon:

curl -fsSL https://github.com/VladoIvankovic/Codeep/releases/latest/download/codeep-macos-arm64 -o codeep chmod +x codeep sudo mv codeep /usr/local/bin/ ```

Quick Start

```bash

Usage Examples

Option 1: npm (Recommended)

npm install -g codeep

Update:

npm update -g codeep

Option 2: curl

For a machine without Node. The script is served from codeep.dev and fetched from this repository's newest release, so the command does not change if the repository moves.

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

Custom installation directory:

curl -fsSL https://codeep.dev/install.sh | INSTALL_DIR=~/.local/bin bash

Specific version:

curl -fsSL https://codeep.dev/install.sh | VERSION=3.1.1 bash

Option 3: Manual Binary

Download the latest binary for your platform from GitHub Releases:

```bash

maxIterations: 12 # optional budget

You write safe, reversible DB migrations… ```

tools is an allowlist enforced at dispatch (a researcher literally can't write files). Sub-agents inherit your profile + project rules, and their changes are covered by /undo.

Guaranteed review: enable Agent Auto-Review in /settings (agentAutoReview) and after any run that changes files, Codeep automatically delegates to the reviewer and appends its findings — a review stage that always happens. Off by default.

Optional Codeep-specific extensions:

codeep-min-version: 2.0.0 codeep-requires-mcp: [postgres] allowed-tools: [read_file, write_file, execute_command]

Self-Verification (Optional)

When enabled in Settings, the agent can automatically verify its changes by running build, tests, or type checking after completing a task. Disabled by default — the agent works freely and you decide when to verify.

Configure in Settings → Agent Auto-Verify: - Off (default) — no automatic verification - Build only — checks compilation after changes - Typecheck only — runs TypeScript/PHP type checking - Test only — runs test suite after changes - Build + Typecheck + Test — full verification

If errors are found, the agent tries to fix them automatically (up to 3 attempts, configurable).

Supported project types:

Personal config sync

account sync / account push also carry your personalities and custom slash commands between machines — the Markdown files in ~/.codeep/personalities/ and ~/.codeep/commands/:

codeep account push   # Upload local personalities + commands to codeep.dev
codeep account sync   # Download them onto a new machine

A manual sync treats the dashboard personality as current. When a changed cloud personality replaces a local file, Codeep first saves the local version under ~/.codeep/backups/personalities/ and then swaps the new file in atomically. Custom commands keep the older additive merge and are never overwritten by a pull. View and edit custom bots in Agent Studio, and prune commands under Custom commands, on the dashboard.

Hooks and MCP server configs are deliberately not synced: hooks run arbitrary shell, and MCP configs often embed tokens, so both stay local to each machine.

AI Configuration

Model favorites — save provider+model combos and switch instantly:

> /provider      # switch to z.ai
> /model glm-5.2
> /profile save fast

> /provider      # switch to openai
> /model gpt-5.6-sol
> /profile save work

> /model fast    # instantly switch to z.ai / glm-5.2
> /model work    # instantly switch to openai / gpt-5.6-sol

Configuration

Config Locations

Environment Variables

Settings (`/settings`)

On first run, enter your API key

API key sync

Add keys once on the dashboard, then sync them to any machine:

codeep account sync   # Pull keys + config from codeep.dev → local
codeep account push   # Push local keys + config → codeep.dev

Keys are encrypted at rest using AES-256-GCM.

Git Integration

• /diff - Review unstaged changes with AI assistance
• /diff --staged - Review staged changes
• /commit - Generate conventional commit messages

Git Integration

Zed Editor Integration (ACP)

Codeep supports the [Agent Client Protocol (