coru.dev ยท official home of the Koru OSS library

๐ŸŒ€ Koru

Open-source closed-loop refactor orchestration

Terminal
pip install koru
koru auto

How It Works

Closed-loop refactor on your repo

Apache-2.0 PyPI ยท koru v0.1.306 Python 3.12+

Python package on PyPI that coordinates LLM-augmented refactor tools with ticket-driven workflow and regression-free verification across multi-repo workspaces.
Detect โ†’ Plan โ†’ Execute โ†’ Verify โ†’ Heal โ†’ Learn โ†’ Repeat

Core Mission

Transform how teams approach large-scale code modernization with intelligent, auditable automation.

๐Ÿ”„

Closed-Loop Automation

Detect issues โ†’ plan fixes โ†’ execute changes โ†’ verify safety โ†’ heal failures โ†’ repeat

๐ŸŽซ

Ticket-Driven Workflow

Structured, auditable refactor pipelines with zero-trust policy gates

๐Ÿ›ก๏ธ

Regression-Free Verification

Multi-tier validation (unit tests, integration tests, semantic analysis)

๐Ÿง 

LLM Orchestration

Coordinate multiple AI agents (Windsurf, Cursor, Claude Code, aider, OpenRouter)

What Koru Delivers

Capabilities shipped in the open-source library โ€” discovery, ticketed execution, IDE automation, verification, and fleet-scale rollout from one CLI.

๐Ÿ”Ž Discovery Passes

Broad codebase analysis that turns signals into concrete planfile tickets

๐ŸŽซ Ticketed Delivery

Planfile-first execution so every change is scoped, auditable, and resumable

๐Ÿค– IDE / Daemon Automation

Cursor, VS Code, Windsurf, and plugin-driven hands-off refactor loops

๐Ÿ›ก๏ธ Verification & Healing

Post-run checks, runtime probes, and recovery paths that keep regressions visible

๐ŸŒ Multi-Repo Rollout

One workflow across matching repositories, from local repair to fleet-wide rollout

๐Ÿ“Š Auditing & Traceability

JSONL event logs, planfile handoffs, and machine-readable history for every run

The Koru Loop

1
DETECT
regix, TestQL, redup, Probe
โ†’
2
PLAN
planfile, Prometheus
โ†’
3
EXECUTE
Windsurf, Cursor, OpenRouter
โ†’
4
VERIFY
pytest, TestQL, vallm
โ†’
5
HEAL
Webhook API, retry loops
โ†’
6
LEARN
pyqual, metrics, dashboards

Connected Ecosystem

20+ integrated tools for the complete refactor automation pipeline

planfile

Ticket backlog & execution gateway

regix

Python regression metrics & tracking

redup

Duplicate detection & deduplication

testql

Declarative HTTP scenario tests

wup

Real-time service dependency health

vallm

Multi-tier semantic patch validator

redsl

OpenRouter-powered auto-refactor

prefact

Proactive LLM-aware linter

costs

Zero-config AI cost per commit

Quick Start

Two commands to install and run Koru on your repo. For wizard, queue mode, scan passes, and other workflows, see the README and CLI examples.

Terminal
pip install koru
koru auto

Operational Modes

IDE-Native (Default)
When: Ticket work
Executor: Windsurf/Cursor LLM + regix/pytest
Headless Automation (Opt-in)
When: Infra tests, scheduled runs
Executor: OpenRouter (redsl, vallm, llx)
Autonomous Loop (24/7)
When: Unattended execution
Executor: Both modes + autopilot injection

By The Numbers

$31.44
Tracked LLM cost
406 commits (koru repo)
0.1.306
PyPI version
Jun 2026
130h
Human dev time
tracked in README
20+
Integrated Tools
Full pipeline

Documentation

Try Koru on your repo

Install from PyPI and run the closed loop on your workspace โ€” see Quick Start for the exact commands.

Open Source Library

Koru (github.com/semcod/koru) is the maintained OSS project behind this site โ€” not a separate commercial product. Install from PyPI, read the docs on GitHub, and contribute under Apache-2.0.

๐Ÿ“ฆ Package

Base CLI with planfile queue, scan, and autopilot protocol. Optional extras cover API, agent, and dev workflows.

๐Ÿงญ First run

Install from PyPI, then run the closed loop on your repo โ€” workspace setup, scan, and ticket execution in one flow. See Quick Start for the two-command sequence.

๐Ÿ“š Source & docs

README ยท docs/ ยท PyPI releases

Validated on semcod monorepos, sample demo workspaces, and other multi-repo setups.