Skip to content

Latest commit

Β 

History

History
147 lines (101 loc) Β· 3.78 KB

File metadata and controls

147 lines (101 loc) Β· 3.78 KB

Code Monkeys πŸš€

CI License Rust

The Solo Product Factory: Constitution-governed automation that fixes bugs while you sleep, ships releases automatically, and scales to 50+ products.


The Problem

You're building multiple products. Every repo needs:

  • CI that stays green
  • Docs that don't drift
  • Releases that follow the rules
  • Hours of maintenance you don't have

Code Monkeys does all of it. Automatically.


What Code Monkeys Does

Pillar What It Does Your Benefit
🧠 Oracle Semantic code understanding Query your codebase in natural language
🩺 Heal LLM-powered CI repair Wake up to green builds
πŸ“š Docs Living documentation README never goes stale
πŸš€ Ship Governed releases One-click publish with guardrails
πŸ‘οΈ Watch Always-on monitoring Catches issues before you do

Why Code Monkeys?

🏠 100% Local

Your code never leaves your machine. Runs on your hardware with Ollama.

πŸ“œ Constitution-Governed

Every action follows your rules. No surprises. Full audit trail.

πŸ”„ Self-Healing

Compiler error at 3am? Fixed by 3:01am. Automatically.

🌐 Fleet-Ready

One product or fifty. Same workflow. Swarm intelligence across repos.


Proof It Works

You: *sleeping*
Code Monkeys: Detected CI failure (E0308: type mismatch)
Code Monkeys: Generated fix via Qwen-7B
Code Monkeys: Applied fix, verified, committed
Code Monkeys: All tests passing βœ…
You: *wake up* β†’ Green CI, fixed code, audit log

Demo it yourself:

# Create a broken test
echo 'fn add(a: i32, b: i32) -> i32 { a - b // bug' > tests/broken.rs

# Generate failure log
cargo test --message-format=json > fail.json

# Watch Code Monkeys fix it
codemonkeys heal --log-file fail.json

Quick Start

# Install
cargo install --path .

# Initialize
codemonkeys init

# Scan your codebase
codemonkeys scan

# Query your code
codemonkeys chat -q "What functions handle errors?"

# Self-heal failures
codemonkeys heal --log-file test.json

# Ship a release
codemonkeys ship --dry-run

Commands

Command Description
codemonkeys init Initialize Code Monkeys in current repo
codemonkeys scan Build Codebase Oracle (parse β†’ graph β†’ embed)
codemonkeys chat Query codebase with natural language
codemonkeys heal Autonomous self-healing for CI failures
codemonkeys ship Governed release pipeline
codemonkeys watch (Coming) Always-on daemon mode

The Vision: Solo Product Factory

Code Monkeys is part of a larger system:

Layer Product Job
Bootstrap CodeMonkeysInit 0 β†’ working repo
Front Half CodeMonkeysDev Spec β†’ Plan β†’ Tasks
Back Half Code Monkeys Heal β†’ Docs β†’ Ship
Fleet CodeMonkeysOrg 50+ products at once

You write Constitution + Spec. The system does the rest.


Documentation


Requirements

  • Rust 1.82+
  • Ollama with qwen2.5-coder:7b-instruct
  • ~2GB disk for models

License

Copyright 2024 Novel Byte Labs. Apache 2.0.