The free, autonomous
coding agent

Comment @kody on a GitHub issue. Get back a planned, built, verified, and reviewed PR.

Get Started npm install
Kody 7-stage pipeline: Taskify → Plan → Build → Verify → Review → Review-Fix → Ship
Real pipeline run — Issue #530 → PR #531
How It Works
Issue to PR in three moments
Kody handles the entire lifecycle autonomously. Here's what you see.
01 — TRIGGER
Comment @kody on any issue
Kody picks up the issue, classifies complexity, and starts the pipeline. Low-risk tasks skip planning and review for speed. High-risk tasks pause for your approval.
GitHub issue with @kody comment triggering the pipeline
02 — PIPELINE
7 stages with quality gates
Classify, plan, build, verify (typecheck + tests + lint), review in a fresh session, fix findings, ship. If verify fails, AI diagnoses the error and autofixes before retrying.
Pipeline summary showing all stages completed
03 — RESULT
A PR that's ready to merge
Rich description with scope, changes, verify status, and Closes #N. Passing quality checks. Implementation plan included. Just review and merge.
Pull request created by Kody with description and passing checks
Why Kody?
Other agents: prompt → code → pray
Kody: research → plan → build → test → review → fix → ship
Capability Typical agents Kody ADE
Execution ✕ Single-shot prompt ✓ 7-stage pipeline with quality gates
Testing ✕ None or optional ✓ Typecheck, tests, lint between stages
Code review ✕ None ✓ AI review in a fresh session, no build bias
Failure handling ✕ Blind retry or abort ✓ AI diagnosis — classifies, fixes, retries
Learning ✕ Starts from scratch ✓ Learns conventions from each run
Tool access ✕ Sandboxed VM ✓ Your CLI, build tools, MCP servers
Models ✕ Locked to one provider ✓ Any LLM, per-stage selection, auto-escalation
Price ✕ $500+/mo or per-seat ✓ Free & open source
Runs on ✕ Hosted service ✓ Your CI, your infra, no data leaves
The Stack
What's under the hood
Seven layers from trigger to inference. Every name you recognize.
GitHub
Trigger — comment @kody on any issue or PR
↓
Kody CLI
Config, state, git, GitHub API
↓
Kody Pipeline Orchestrator
7-stage SDLC with quality gates
↓
⚡
Superpowers
TDD, planning, code review, auto-diagnosis
↓
Claude Code
Autonomous agent — shell, files, tools, MCP
↓
LiteLLM
Model routing — use any LLM, including free ones
↓
LLMs
Anthropic · OpenAI · Gemini · MiniMax
Features
Built for real codebases
Not a toy. Every feature exists because autonomous pipelines break without it.
⚙

Repo-Aware Prompts

bootstrap analyzes your codebase and generates customized instructions for every stage. Not generic prompts—your patterns, your conventions.

📚

Auto-Learning

After each run, Kody extracts coding conventions, patterns, and architectural decisions. The next run is smarter than the last.

🔁

Shared Sessions

Stages share Claude Code sessions. The build agent already knows the codebase from planning. No cold-start re-exploration between stages.

🚨

Auto Fix-CI

CI fails on a Kody PR? It fetches the logs, diagnoses the failure, and pushes a fix automatically. With loop guards to prevent infinite retries.

👁

Kody Watch

Periodic health monitoring. Pipeline health, security scanning, config validation. Posts findings as GitHub issues.

GitHub Native

Runs as a GitHub Action, not a hosted service. Posts progress updates to issues, creates PRs, comments results. Your code never leaves your infra.

⚡

Local Serve

kody serve starts the same infrastructure locally—LiteLLM proxy, dev server, project memory. Launch Claude Code CLI or VS Code with one command.

🔄

Parallel Decomposition

@kody decompose splits complex tasks into independent sub-tasks that build in parallel, then merge, verify, and ship as one PR.

🔍

Standalone PR Review

@kody review on any PR for structured code review with findings, severity levels, and GitHub approve or request-changes verdict.

Commands
One tool for every situation
Comment on GitHub or run from your terminal.
Command What it does
@kody Run full pipeline on an issue
@kody review Standalone PR review with structured findings + GitHub approve/request-changes
@kody fix Re-run from build with human PR feedback as context
@kody fix-ci Fetch CI failure logs, diagnose, and push a fix
@kody resolve Merge default branch into PR, AI-resolve conflicts, verify
@kody rerun Resume from failed or paused stage
@kody bootstrap Analyze repo, generate memory + step files + labels
@kody approve Resume after questions or risk gate pause
kody-engine serve Start LiteLLM proxy + dev server locally (infra only)
kody-engine serve claude Above + launch Claude Code CLI with proxy routing
kody-engine serve vscode Above + launch VS Code with proxy routing
Quick Start
Running in 5 minutes
A GitHub repo + an Anthropic API key. That's all you need.
# 1. Add your API key
$ gh secret set ANTHROPIC_API_KEY --repo owner/repo

# 2. Initialize (generates workflow + config)
$ npm install -g @kody-ade/engine
$ cd your-project && kody-engine init
✓ .github/workflows/kody.yml
✓ kody.config.json (auto-configured)
✓ All checks passed! Ready to use.

# 3. Bootstrap (optional — generates repo-aware prompts)
Comment on any issue: @kody bootstrap

# 4. Use
Comment on any issue: @kody
Watch: planning → building → review → done → PR created
● Free & Open Source · MIT License

Stop babysitting your CI.
Let Kody ship it.

Set up in 5 minutes. Works with any GitHub repo.

Get Started Free View on GitHub