>_IronCode
@@@  @@@@@@@    @@@@@@   @@@  @@@      @@@@@@@   @@@@@@   @@@@@@@   @@@@@@@@
@@@  @@@@@@@@  @@@@@@@@  @@@@ @@@     @@@@@@@@  @@@@@@@@  @@@@@@@@  @@@@@@@@
@@!  @@!  @@@  @@!  @@@  @@!@!@@@     !@@       @@!  @@@  @@!  @@@  @@!     
!@!  !@!  @!@  !@!  @!@  !@!!@!@!     !@!       !@!  @!@  !@!  @!@  !@!     
!!@  @!@!!@!   @!@  !@!  @!@ !!@!     !@!       @!@  !@!  @!@  !@!  @!!!:!  
!!!  !!@!@!    !@!  !!!  !@!  !!!     !!!       !@!  !!!  !@!  !!!  !!!!!:  
!!:  !!: :!!   !!:  !!!  !!:  !!!     :!!       !!:  !!!  !!:  !!!  !!:     
:!:  :!:  !:!  :!:  !:!  :!:  !:!     :!:       :!:  !:!  :!:  !:!  :!:     
 ::  ::   :::  ::::: ::   ::   ::      ::: :::  ::::: ::   :::: ::   :: ::::
:     :   : :   : :  :   ::    :       :: :: :   : :  :   :: :  :   : :: ::
Open source · MIT License · Built on Bun + Rust

The AI coding agent
that ships with you

IronCode reads your codebase, writes production-ready code, runs tests, reviews PRs, and ships — all from a single terminal command. No cloud upload required.

Get Started in Seconds

Windows

❯
npm install -g ironcode-ai

Install via npm or download the .exe from GitHub releases

macOS

$
brew tap KSD-CO/tap
brew install ironcode

Install via Homebrew or download from GitHub releases

Linux

$
npm install -g ironcode-ai

Install via npm or download the binary from GitHub releases

Chat Integrations

Telegram Bot

Remote Control

Control IronCode from your phone — upload images, files, send voice messages.

$ bun install -g @ironcode-ai/telegram
$ ironcode-telegram setup
📸Image upload (screenshots, diagrams)
📄File upload (up to 20MB)
🎤Voice transcription

Setup guide →

Discord Bot

Slash Commands

Modern Discord integration with slash commands, embeds, and file upload.

$ bun install -g @ironcode-ai/discord
$ ironcode-discord setup
⚡Slash commands (/start, /diff, /info)
📸Image & file upload (up to 25MB)
✨Rich embeds & reactions

Setup guide →

Everything you need

Build better software, faster

IronCode provides all the tools you need to accelerate your development workflow and ship quality code with confidence.

Multi-Account Providers

Connect multiple API keys per provider (Anthropic, OpenAI, Google, Copilot, etc.) and distribute requests with automatic round‑robin.

Local Code Search (BM25)

Semantic offline code search with BM25 + tree‑sitter — find functions and symbols by concept (no ML models required).

Native Bash Permissions

Native Rust permission checks, a tree‑sitter bash parser and RETE rules for fast, accurate command classification.

Editor & Terminal Improvements

External editor auto‑install + redesigned built‑in terminal with streaming output, autosuggest and tab completion.

Code Changes Panel

View diffs, add inline comments and revert individual hunks directly inside the TUI for faster reviews.

AI SDK v6 Integration

DevTools middleware, token‑saving optimizations and provider‑specific tools for richer model interactions.

Streaming & Memory Optimizations

Streaming file reads and grep reduce memory by 90%+, plus selective loading and Rust rewrites for much lower RAM use.

Built‑in Skills

13 production workflows out of the box — TDD, systematic debugging, verification, browse, QA, QA report‑only, API testing, code review, ship, document release, retro, CEO review, and eng review. Auto‑extracted, upgradeable, customizable.

Context‑Aware Intelligence

IronCode understands your codebase and coding style to provide accurate, contextually relevant suggestions.

Git Source Control UI

Full Git integration in the TUI — stage, commit, branch and push with syntax‑highlighted diffs and shortcuts.

Secure & Private

All processing stays local by default — your code never leaves your machine unless you opt in.

Chat Integrations

Control IronCode from Telegram, Discord, or Slack. Upload images & files, send voice messages, and get live streaming responses — code from anywhere, even mobile.

Voice to Code

Send voice messages via Telegram or Discord — audio is automatically transcribed by Groq Whisper and forwarded to the agent. Hands-free coding on the go.

AI‑Driven Development

One Agent, Nine Specialist Modes

Each slash command switches IronCode into a different expert — from founder to eng manager. Chain them together for a complete development workflow, or use any skill standalone.

/ceo-reviewFounder

Rethink the Problem

Don't just build what was asked. Find the 10‑star product hiding inside the request. Three modes: Scope Expansion, Hold Scope, Scope Reduction.

/eng-reviewTech Lead

Lock the Architecture

Architecture, data flow, failure modes, edge cases, and test matrix. Walk through issues interactively with opinionated recommendations.

/tddDeveloper

Build with TDD

RED‑GREEN‑REFACTOR: write a failing test, minimal code to pass, refactor. Iron Law — no production code without a failing test first.

/debugDebugger

Fix It Right

When stuck: 4‑phase systematic debugging — root cause, pattern analysis, hypothesis testing, implementation. 3‑fix rule escalates architectural issues.

/code-reviewStaff Engineer

Find the Bugs

Two‑pass review: critical issues first (type safety, injection, concurrency), then informational (patterns, performance, test gaps).

/verifyGatekeeper

Prove It Works

Run the command, read the output, then claim the result. No 'should work' — evidence before assertions, always.

/code-shipRelease Engineer

Land It

Merge, test, typecheck, changelog, bisectable commits, push, and PR — fully automated in one command.

/qaQA Engineer

Verify It

Web UI? Playwright tests pages, forms, flows. REST API? Discovers routes, tests every endpoint with valid/invalid/edge‑case payloads. Also: /qa-only (report only) and /qa-api (API‑specific).

/document-releaseTechnical Writer

Update the Docs

Cross‑references the diff against README, ARCHITECTURE, CONTRIBUTING, CHANGELOG. Auto‑fixes facts, polishes voice.

/retroEng Manager

Reflect & Improve

Weekly retro: commit analysis, session detection, team contributions, per‑person praise, growth areas. Persistent history with trends.

The complete software delivery pipeline — driven by AI

Every skill is embedded in the binary. No plugins to install, no setup required. Just type the slash command and go.

/ceo-review/eng-review/tdd/debug/code-review/verify/code-ship/qa/document-release/retro

Chat Integrations

Code from anywhere with IronCode's chat bot integrations. Upload files, share screens, and get AI assistance directly in your favorite messaging apps.

Available

Telegram

@ironcode-ai/telegram

Chat with IronCode from Telegram. Upload images, files, and voice messages for AI analysis.

  • 📸 Image upload (screenshots, diagrams)
  • 📄 File upload (up to 20MB)
  • 🎤 Voice transcription
  • 📦 Media groups support
# Install
bun install -g @ironcode-ai/telegram
Available

Discord

@ironcode-ai/discord

Use slash commands in Discord to control IronCode. Rich embeds and file upload support.

  • ⚡ Slash commands (/start, /info, /diff)
  • 📸 Image & file upload (up to 25MB)
  • 🎤 Voice message transcription
  • ✨ Rich embeds for better UX
# Install
bun install -g @ironcode-ai/discord
Available

Slack

@ironcode-ai/slack

Run IronCode in Slack channels with threaded conversations and real-time updates.

  • 💬 Threaded conversations
  • ⚡ Real-time tool notifications
  • 🔗 Session sharing
  • 🤖 Socket mode support
# Install
bun install -g @ironcode-ai/slack

Why Use Chat Integrations?

📱

Code from Mobile

Send quick fixes or review code from your phone while on the go

🤝

Team Collaboration

Share sessions with teammates and collaborate in real-time

🎤

Voice to Code

Describe changes verbally and let AI implement them

Quick Setup Example

Telegram Bot

# Install
bun install -g @ironcode-ai/telegram
# Configure
ironcode-telegram setup
# Run
ironcode-telegram

Discord Bot

# Install
bun install -g @ironcode-ai/discord
# Configure
ironcode-discord setup
# Run
ironcode-discord
View Full Documentation

See it in action

Watch IronCode transform your workflow

From idea to implementation in minutes. See how IronCode handles real-world development tasks.

Full-stack feature implementation

IronCode can build complete features including frontend components, API endpoints, database schemas, and tests - all from a single prompt.

Intelligent code refactoring

Automatically improve code quality, fix performance issues, and apply best practices across your entire codebase.

Bug detection and fixing

IronCode identifies potential bugs, security vulnerabilities, and edge cases, then provides fixes with detailed explanations.

terminal
# Step 1: Install IronCode
$
✓ Downloading IronCode...
✓ Installed successfully

FAQ

Frequently asked questions

Everything you need to know about IronCode. Can't find what you're looking for? Reach out to our team.