Home

🧬 CodeGenesis

A .NET CLI engine that orchestrates multi-step AI pipelines using Claude Code as the execution backend.

Define pipelines in YAML · Compose agents with Markdown bundles · Let Claude handle the rest

---

📖 Wiki Navigation

	Page	Description
🚀	Getting Started	Prerequisites, installation and first pipeline
💻	CLI Reference	run and run-pipeline commands
📋	Pipeline YAML Reference	YAML structure, template variables, max_turns
🔀	Step Types	Simple, Foreach, Parallel, ParallelForeach, Approval, UsePipeline
🔌	MCP Servers	Custom tools via MCP stdio protocol
📦	Context Bundles	Reusable agent instruction packages
⚙️	Configuration	Environment variables, appsettings.json, logs
🏗️	Project Structure	Full source tree and architecture
🧪	Testing	Test project, coverage, CI pipeline

---

🔄 How It Works

graph LR
    A[📄 YAML Pipeline] --> B[🧬 CodeGenesis Engine]
    B --> C[🤖 Claude Code CLI]
    C --> D[📝 Plan]
    C --> E[⚡ Execute]
    C --> F[✅ Validate]
    D --> G[📦 Output]
    E --> G
    F --> G

Loading

⚡ Quick Start

# Clone & build
git clone https://github.com/viamus/code-genesis.git && cd code-genesis
dotnet build

# Run a pipeline
dotnet run --project CodeGenesis.Engine -- run-pipeline examples/hello-world.yml

# Run an ad-hoc task
dotnet run --project CodeGenesis.Engine -- run "Add retry logic to the HttpClient service"

Tip

Check the Getting Started page for detailed setup instructions.