code-evolve
Autonomous CLI that builds and improves a project from a vision and spec across scheduled sessions.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
Node.js >= 18,Python 3 - System packages:
Git - Keys or accounts: ANTHROPIC_API_KEY, OPENAI_API_KEY
Install code-evolve globally via npm
npm install -g code-evolve
Check that it works
code-evolve --versionThe output should contain “0.2.0”.
First thing to try
mkdir -p evolve-demo/docs && cat > evolve-demo/docs/technical-spec.md <<'EOF'
# Technical Spec: Task Tracker
## Overview
A simple task tracker web app.
## Tech Stack
- TypeScript with Node.js
- SQLite for storage
## Architecture
Single-process server with REST API and static frontend.
## Features
- [ ] User authentication with JWT
- [ ] Task CRUD API
- [ ] Rate limiting middleware
EOF
cat evolve-demo/docs/technical-spec.mdcd evolve-demo && code-evolve migrate spec ./docs/technical-spec.md --yesGo to your project folder and run code-evolve migrate spec <file> --yes to turn an existing spec into code-evolve format.
What it does
- Convert existing docs to code-evolve formatTested
How to use it
- In your project folder, run
code-evolve migrate spec <spec-file> --yesto pull the features out of an existing spec. - Run
code-evolve migrate vision <vision-file> --yesto convert an overview document into .evolve/vision.md.
- In your project folder, run
- Build a project from a vision and specNot tested
- Improve a project over repeated sessionsNot tested
- Create a vision file through a guided interviewNot tested
How far pickfit got
Linux x86_64
- Installs
- Starts
- 1 of 4 features work
- Works offline
Good for
- Generate vision document via guided interview
- Convert existing spec document into code-evolve format
- Run autonomous evolution engine on schedule
- Run one evolution cycle manually
- Check build progress with status
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 0.2.0
Differences the test machine hit
- README: npx code-evolve init creates .evolve/ with templates
In the test: init checks for agent binary (claude/codex/opencode/ollama) plus python3 and git and exits 3 with 'Missing required dependencies' when absent; Requirements lists the agent but Getting Started does not warn - README: code-evolve status checks progress after init
In the test: migrate without init only creates .evolve/ dir with spec.md/vision.md; status still exits 1 'Not initialized' until full init provides scripts/evolve.sh and IDENTITY.md