Iron Rain
╭━━╮╭━━━╮╭━━━╮╭━╮╱╭╮   ╭━━━╮╭━━━╮╭━━╮╭━╮╱╭╮
╰┫┣╯┃╭━╮┃┃╭━╮┃┃┃╰╮┃┃   ┃╭━╮┃┃╭━╮┃╰┫┣╯┃┃╰╮┃┃
╱┃┃╱┃╰━╯┃┃┃╱┃┃┃╭╮╰╯┃   ┃╰━╯┃┃┃╱┃┃╱┃┃╱┃╭╮╰╯┃
╱┃┃╱┃╭╮╭╯┃┃╱┃┃┃┃╰╮┃┃   ┃╭╮╭╯┃╰━╯┃╱┃┃╱┃┃╰╮┃┃
╭┫┣╮┃┃┃╰╮┃╰━╯┃┃┃╱┃┃┃   ┃┃┃╰╮┃╭━╮┃╭┫┣╮┃┃╱┃┃┃
╰━━╯╰╯╰━╯╰━━━╯╰╯╱╰━╯   ╰╯╰━╯╰╯╱╰╯╰━━╯╰╯╱╰━╯

Multi-model orchestration for coding agents

Route tasks to the right model at the right time. Use any provider — Anthropic, OpenAI, Ollama, or your existing CLI subscriptions.

Get Started View on npm GitHub
$ curl -fsSL https://raw.githubusercontent.com/howlerops/iron-rain/main/scripts/install.sh | bash
$ iron-rain

Thread Weaving

Orchestrate multiple models in parallel. The main model delegates exploration and execution to specialized slots, then integrates results.

Any Provider

Works with Anthropic, OpenAI, Ollama, LM Studio, or any OpenAI-compatible API. Use CLI subscriptions too — Claude Code, Codex, Gemini CLI.

Tool-aware Routing

Automatically routes file edits to your execute slot, grep/search to explore, and strategy to main. Configurable per tool type.

Plan & Execute

Generate a PRD and task breakdown with /plan. Review, approve, and auto-execute through Forge with optional auto-commit per task.

Iterative Loop

Run tasks repeatedly with /loop until a condition is met. Auto-detects when stuck and suggests new strategies.

Skills & MCP

Auto-discover markdown skill files as slash commands. Connect MCP servers for external tool integration.

Persistent Memory

SQLite-backed sessions with cross-session lessons. Thinking level control (off/low/medium/high) per slot across all providers.

@ Context References

Inject files, directories, git state, or images into prompts with @./file, @git:diff, @dir:src/. Multimodal image support included.

Mid-Stream Injection

Add context while the agent is streaming. The response pauses, your input is injected, and generation resumes with full history.

Subagent Grid

Responsive multi-agent display with status dots, tool-call trees, and per-card stats. Adapts to terminal width automatically.

Plugin SDK

Extend Iron Rain with plugins. Hook into dispatch lifecycle events, modify tasks, and add custom behaviors.

Project Init

Run /init to analyze your codebase — maps repo structure, extracts tech stack and conventions, and stores findings as persistent lessons.

Code Review

Review staged changes or branch diffs with /review. Get structured feedback on bugs, security, performance, and style.

Checkpoints & Undo

Git-based checkpoint system with /undo to restore previous states. Automatic checkpoints during plan execution.

Cost Tracking

Per-model cost registry with configurable input/output token pricing. Track spend across slots and sessions.

Project Rules

Define coding standards in IRON-RAIN.md or .iron-rain/rules/. Rules are injected into every system prompt automatically.

Repo Map

Auto-generated repository map with file structure and extracted symbols. Gives the model structural awareness of your codebase.

Sandbox Execution

Run commands in isolated sandboxes — macOS Seatbelt, Docker, or gVisor. Control network access and write paths.

Fuzzy Commands

Mistype a command? Iron Rain suggests the closest match using Levenshtein distance. /upgade → "Did you mean /update?"

Three Model Slots

Each slot serves a distinct purpose. Assign any model to any slot.

Cortex

Strategy & Planning

Handles conversation, planning, and high-level reasoning. Your most capable model goes here.

Scout

Search & Research

Read-only exploration. Grep, glob, search, and codebase understanding. Can be a fast, cheap model.

Forge

Edit & Execute

File writes, bash commands, and code generation. Needs a model strong at following precise instructions.

Simple Configuration

// iron-rain.json { "slots": { "main": { "provider": "anthropic", "model": "claude-opus-4-6" }, "explore": { "provider": "ollama", "model": "qwen2.5-coder:32b" }, "execute": { "provider": "openai", "model": "gpt-4o" } }, "providers": { "anthropic": { "apiKey": "env:ANTHROPIC_API_KEY" }, "openai": { "apiKey": "env:OPENAI_API_KEY" }, "ollama": { "apiBase": "http://localhost:11434" } } }

howlerops Ecosystem

Iron Rain is part of the howlerops family of open-source AI infrastructure tools.