Ix maps software architectures to generate system diagrams that improve AI reasoning and reduce token usage.

https://t.co/0mkcvkRzOR https://t.co/NcONEK2eAD

ix-infrastructure/Ix

Source: https://github.com/ix-infrastructure/Ix

Understand any codebase instantly.

Your context saver and virtual cartographer.

Website · Docs · Demo . Discord

⭐ Star this repo if you find it useful

Problem

Running out of tokens while developing? Not anymore…

Modern software is complicated.

You read code. You search logs. You still guess.

AI can’t reason about systems. LLMs can’t remember them either.

Ix fixes both.

Demo

Stop digging through files. Open the map instead.

Ix improves how AI systems reason about your codebase.

Results

30-99.7% fewer tokens on development tasks
Minimum of 43% increase in daily LLM usage
Understand systems in minutes, not hours

Directed context. More signal. Persistent system memory.

Install

Linux/MacOS

curl -fsSL https://ix-infra.com/install.sh | sh

Windows

irm https://ix-infra.com/install.ps1 | iex

Claude Plugin

/plugin marketplace add ix-infrastructure/ix-claude-plugin
/plugin install ix-memory
/reload-plugin

Codex Plugin

macOS / Linux:

curl -fsSL https://ix-infra.com/codex-install.sh | sh

Windows (PowerShell):

irm https://ix-infra.com/codex-install.ps1 | iex

OpenClaw Plugin

openclaw plugins install ix-infrastructure/ix-openclaw-plugin

Gemini Extension

gemini extensions install https://github.com/ix-infrastructure/ix-gemini-plugin

OpenCode Plugin

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/ix-infrastructure/ix-opencode-plugin/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/ix-infrastructure/ix-opencode-plugin/main/install.ps1 | iex

Cursor Plugin

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/ix-infrastructure/ix-cursor-plugin/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/ix-infrastructure/ix-cursor-plugin/main/install.ps1 | iex

Requirements

The install script sets up everything for you on macOS and Linux. It checks for and installs anything that is missing:

• Node.js 20 or newer
• Git
• ripgrep (powers ix text)
• Docker and Docker Compose (for the local backend)

All you need beforehand is a terminal with curl (or wget). On Windows, install Node.js 20+ and Docker Desktop first, then run the installer.

Works on macOS, Linux, and Windows, on both x86-64 and arm64.

Supported Languages

Ix parses and extracts symbols, calls, and imports across 26 languages, and recognizes several more config and data formats.

Languages: JavaScript, TypeScript, Python, Java, C, C++, C#, Go, Ruby, Rust, PHP, Kotlin, Swift, Scala, R, SAS, Elixir, Haskell, Zig, Lua, Bash, HTML, XML, CSS, HCL / Terraform, Makefile

Also recognized: YAML, JSON, TOML, SQL, Dockerfile, Markdown

Quick Start

Map your system:

ix map .

Understand a component:

ix explain auth-service

Trace a flow:

ix trace user_login_flow

Analyze impact:

ix impact database.schema

Stop guessing. Start navigating.

Map → Explain → Trace → Impact

Why Ix

Modern systems are not just complex, they’re constantly changing.

Every time you switch context, onboard to a new service, or debug a flow, you start from zero.

• knowledge is fragmented across code, logs, and people
• context is lost between sessions
• understanding does not persist

AI doesn’t solve this. It amplifies it: reasoning is limited to the current prompt, and memory disappears between interactions.

Ix is built to fix this at the system level.

• builds a structured map of your system
• captures relationships and flows
• persists understanding over time
• gives both humans and AI a shared source of truth

Stop re-learning your system. Start navigating it.

Use Cases

Ix is most useful for:

• large codebases
• unfamiliar systems
• onboarding new engineers
• debugging complex flows
• improving LLM-assisted development

The Shift

Ix turns your system into a living map.

Not static diagrams. Not outdated docs.

A map you can explore. A map you can trace. A map that evolves with your system.

With Ix you can:

• Understand architecture instantly
• Trace how anything works
• See impact before making changes
• Debug systems faster
• Build persistent system memory over time

Built for humans and AI

Developers use Ix to explore and understand systems.

LLMs use Ix as persistent system memory.

Instead of guessing from limited context, AI can navigate a real system map, with structure, history, and relationships.

The result:

• better reasoning
• more consistent answers
• understanding that compounds over time

Architecture

How it works:

1. Map: build a system map from code and signals
2. Structure: identify boundaries, flows, and relationships
3. Remember: persist decisions and system knowledge
4. Understand: explore, trace, and analyze with context

Core Capabilities

A living system map
Your architecture, always up to date.

Trace flows instantly
Follow how anything moves through your system.

Understand impact
See what changes affect before you make them.

Persistent system memory
Knowledge builds over time.

AI-assisted reasoning
Explore systems with both humans and AI.

Philosophy

Every complex system should have a map.

Ix gives you yours.

LLMs process. Ix remembers.

Early stage. Rapidly evolving.

If you’re building complex systems, we’d love your feedback.

Contributing

We welcome contributions.

If you’re building with Ix or want to improve it:

• open an issue
• submit a PR
• share feedback

Early stage. Moving fast.

Status

Ix is in early development (alpha).

APIs and behavior may change.