# Ix

> Open-source CLI tool that parses any codebase into a persistent graph of symbols, calls, and imports so developers and AI agents can query code structure instead of grepping files.

Ix is an open-source code intelligence tool built by Ix Infrastructure, Inc. and licensed under Apache 2.0. It parses repositories using tree-sitter into a persistent local graph of symbols, calls, and imports, giving both developers and AI coding agents a structured way to navigate any codebase. The project reached v0.10.8 as of September 2026 and has accumulated nearly 900 GitHub stars since its March 2026 launch.

## What It Is

Ix is a CLI-first code intelligence layer that maps a repository once and keeps that map alive between sessions. Instead of re-reading files or pasting whole modules into an AI prompt, developers and agents query a local graph database (ArangoDB plus a memory layer, run in Docker) for bounded, precise answers about any symbol, flow, or dependency. The tool also ships an MCP server so any MCP-capable AI client can use the same graph tools directly.

## How the Graph Model Works

The core pipeline is **Map → Structure → Retrieve → Remember**:

- `ix map .` runs tree-sitter over the repo and extracts symbols, calls, and imports as nodes and edges.
- The graph is stored locally in ArangoDB and persists between sessions and agent runs.
- Commands like `ix explain`, `ix trace`, `ix impact`, and `ix callers` return bounded structural slices rather than whole files.
- `ix watch` keeps the graph current as files change.
- `ix view` opens Compass, a browser-based visualizer of the graph.

The README notes that across internal development work, querying the graph instead of feeding files into a prompt cut token use by 30–99.7%, varying with task and repo size. These are described as internal measurements, not a published benchmark.

## Language and Integration Coverage

Ix extracts symbols, calls, and imports across **27 languages**, including JavaScript, TypeScript, Python, Java, C, C++, C#, Go, Ruby, Rust, PHP, Kotlin, Swift, Scala, Elixir, Haskell, Zig, Lua, Bash, PowerShell, HCL/Terraform, and more. CUDA files are parsed with the C++ grammar. Config and data formats such as YAML, JSON, TOML, SQL, Protocol Buffers, Dockerfile, and Markdown are also recognized.

For AI client integration, `ix mcp install` auto-detects and registers the MCP server with **Claude Code, Codex, Cursor, VS Code, Gemini CLI, OpenClaw, and opencode**. Native plugin packages are also available for each client. An agent skill file in `skills/ix/` follows the Claude Code skill format and the agents.md standard, so multiple harnesses load the same skill tree.

## Setup Path

Installation on macOS and Linux requires only `curl`:

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

On Windows, Node.js 22+ and Docker Desktop are prerequisites, then a PowerShell one-liner handles the rest. The installer checks for and installs Node.js 22+, Git, ripgrep, and Docker Compose automatically. Pre-built CLI packages cover Apple Silicon macOS, Linux (x86-64 and arm64), and Windows x86-64; Intel Macs can install via Homebrew from source.

## Update: v0.10.8

The latest release is **v0.10.8**, published on September 6, 2026. The repository was last pushed to on September 24, 2026, indicating active development. The project launched in March 2026 and has moved through ten minor versions in roughly six months. Alongside Ix, the team is building **Kartr**, an agent platform that extends the same memory engine to non-code sources (email, calendar, meetings, team chat) and is currently in alpha with early-access onboarding.

## Features
- Parse any repository into a persistent local graph of symbols, calls, and imports
- Query code structure with commands like ix explain, ix trace, ix impact, ix callers
- MCP server for AI client integration (Claude Code, Codex, Cursor, VS Code, Gemini CLI, OpenClaw, opencode)
- Supports 27 programming languages via tree-sitter
- Compass browser-based graph visualizer (ix view)
- Persistent graph survives between sessions and agent runs
- ix watch for continuous re-mapping on file changes
- Agent skill file compatible with Claude Code skill format and agents.md standard
- Structural smell detection (ix smells)
- Token-minimal LLM output format for agent consumption
- Git history and diff support (ix history, ix diff)
- Local backend via ArangoDB + Docker Compose

## Integrations
Claude Code, Codex, Cursor, VS Code, Gemini CLI, OpenClaw, opencode, ArangoDB, Docker, tree-sitter, MCP (Model Context Protocol), Homebrew

## Platforms
WINDOWS, MACOS, LINUX, API, VSC_EXTENSION, CLI

## Pricing
Open Source

## Version
v0.10.8

## Links
- Website: https://www.ix-infra.com
- Documentation: https://github.com/ix-infrastructure/Ix/tree/main/docs
- Repository: https://github.com/ix-infrastructure/Ix
- EveryDev.ai: https://www.everydev.ai/tools/ix
