AIRK

Open source · Local first · Beta

Give your agent
the source.

Local code and document evidence, ready for your coding agent.

AIRK indexes your workspace and returns focused facts and passages with their original locations. Your agent brings the reasoning. AIRK brings the evidence.

Get the VS Code extension Explore the source

Windows x64 · macOS Apple silicon & Intel · Linux x64

A workspace, made retrievable Illustration

your-workspace/

├─ src/auth.tscode

├─ docs/design.mddecisions

└─ specs/requirements.docxdocuments

AIRK · local collection

Evidence returned to your agent

A definition. A requirement. The lines around it.

source pathcontent hashoriginal location

Bounded results, traceable to indexed source.

Local runtimeMemory and disk on your machine

15 read-only MCP toolsScoped to your workspace collection

Native helper includedNo Docker or build tools to install

01 / Get AIRK

Your workspace.
Your platform.

Download the extension for the machine running your workspace. Each VSIX includes its matching native helper.

The first download is on its way.

AIRK is in beta. Packaged downloads will appear here after the first GitHub release is published. You can explore the source and build instructions now.

Explore AIRK on GitHub
Install the extension

In VS Code, open the command palette and run Extensions: Install from VSIX. Select your download, then open a trusted workspace.

Installation guide

Using SSH, WSL or a development container? Choose the package for the remote workspace host. AIRK requires desktop VS Code; browser-only workspaces cannot run its native helper.

02 / From files to context

A small tool.
A grounded workflow.

Keep the index on your machine, see what is covered, and give your agent a way back to the original material.

  1. 1

    Index your workspace

    Click the AIRK status item to index. Review measured coverage, choose an indexing mode, or pause automatic updates from AIRK controls.

  2. 2

    Connect your agent

    Run AIRK: Set Up Coding Agent to preview scoped configuration for clients such as Claude Code, Codex and Gemini CLI. Enable the connection in your client.

  3. 3

    Retrieve with a reference

    Your agent can search, inspect definitions and read document evidence. Results retain source paths, content hashes and original locations within a published index revision.

AIRK runs locally without a service account or API key. Your chosen agent controls whether it sends retrieved evidence to its model provider.

03 / More than source code

The context lives
across your files.

See formats and extraction limits
Code & configuration
Native grammar profiles for Rust, Python, TypeScript, Go, C#, Swift and more. Structured adapters for JSON, YAML, TOML and other configuration formats.
Documents & decisions
Markdown, text-layer PDFs, DOCX and PPTX. Retrieve passages and evidence cues such as headings, dates, requirements and numeric bounds.
Tables & worksheets
DOCX tables and XLSX stored cells preserve row and cell locations. Spreadsheet formulas retain stored results; AIRK does not recalculate them.

Artifact Indexing and Retrieval Kernel

Open to inspection.
Built to stay local.

AIRK is an independent beta, licensed under Apache-2.0. Read the implementation, explore the documented limits, or help improve it.

Find AIRK on GitHub