Skip to main content
Adist is a powerful CLI tool that helps you understand and interact with your codebase through intelligent indexing, semantic search, and AI-powered conversations. Developed by okik.ai, Adist uses advanced techniques like block-based indexing and large language models to provide deep insights into your projects.
This is an active development project. Breaking changes may occur between versions as we continue to improve the tool. Please check the changelog when updating.

​
What is Adist?

Adist transforms how you navigate and understand large codebases by:
  • Indexing your project files using semantic block-based analysis
  • Enabling natural language search across your entire codebase
  • Providing AI-powered insights through interactive chat and query capabilities
  • Supporting multiple projects with easy switching between them

​
Key features

Fast semantic search

Search your codebase using natural language queries with block-based indexing for precise results

AI-powered chat

Have interactive conversations with AI about your codebase with persistent context

Multi-project support

Manage and switch between multiple projects seamlessly

LLM summarization

Generate intelligent summaries of your code files and entire projects

Block-based indexing

Index code at the function and section level for more precise analysis

Multiple LLM providers

Choose between Anthropic Claude, OpenAI GPT, or local Ollama models

​
How it works

Adist uses a sophisticated indexing system that:
  1. Scans your project directory for supported file types (code, markdown, configuration files, etc.)
  2. Splits documents into semantic blocks using syntax-aware parsing
  3. Creates embeddings for each block to enable semantic search
  4. Optionally generates AI summaries for files and the overall project
  5. Enables instant searching through natural language queries

​
Supported file types

Adist indexes a wide range of file types including:
  • Code files: .js, .ts, .py, .go, .rs, .java, .cpp, and more
  • Documentation: .md, .txt, .rst, .asciidoc
  • Configuration: .json, .yaml, .toml, .ini
  • And many more

​
LLM provider options

Adist supports three LLM provider options:
Cloud-based solution with powerful Claude models:
  • Claude 3 Opus
  • Claude 3 Sonnet
  • Claude 3 Haiku
Requires ANTHROPIC_API_KEY environment variable.

​
Configuration storage

Adist stores its configuration and indices in platform-specific directories:
  • macOS: ~/Library/Application Support/adist
  • Linux: ~/.config/adist
  • Windows: %APPDATA%\adist

​
Next steps

Install Adist

Get started by installing Adist globally with npm

Quick start guide

Learn how to initialize your first project and start searching

Build docs developers (and LLMs) love

Get started for freeTalk to us