← Home

DOCUMENTATION

Everything you need to use Neo Code

Getting Started

3 pages
getting-started

Getting Started

Neo Code is a Neosantara-first AI coding agent that runs in your terminal.

configuration

Configuration

Neo Code uses JSON settings files and a directory structure for configuration.

env

Environment variables

All environment variables read by Neo Code at runtime. Server-side only —

Core Usage

4 pages
tools

Tools

Neo Code exposes tools to the AI model for interacting with your codebase.

sessions

Sessions

Neo Code sessions are stored as trees, enabling branching, forking, and

compaction

Compaction & Branch Summarization

LLMs have limited context windows. When conversations grow too long, Neo Code

memory

Memory System

Neo Code persists context across sessions using an automatic memory system.

Advanced

4 pages
subagents

Subagents

Subagents are parallel workers that handle tasks independently with their own

extensions

Extensions

Extensions are TypeScript modules that extend Neo Code's behavior. They can

skills

Skills

Skills are installable packages that extend Neo Code with specialized

lsp

Code intelligence (LSP)

Neo Code can use real Language Server Protocol (LSP) servers to navigate code

Reference

2 pages
themes

Themes

Neo Code supports full JSON-based theming with 50+ color tokens.

termux

Termux Support

Neo Code has first-class support for Android via Termux.

Other

9 pages
custom-providers

Custom Providers

Extensions can register custom model providers via `neo.registerProvider()`, and

json-mode

JSON Event Stream Mode

```bash

keybindings

Keybindings

All keyboard shortcuts can be customized via `~/.neo-code/agent/keybindings.json`.

prompt-templates

Prompt Templates

Prompt templates are Markdown snippets that expand into full prompts. Type

rpc

RPC Mode

RPC mode enables headless operation via a JSON protocol over stdin/stdout.

session-format

Session File Format

Sessions are stored as JSONL (JSON Lines) files. Each line is a JSON object with

shell-aliases

Shell Aliases

Neo Code runs bash in non-interactive mode (`bash -c`), which doesn't expand

terminal-setup

Terminal Setup

Neo Code uses the [Kitty keyboard protocol](https://sw.kovidgoyal.net/kitty/keyboard-protocol/)

tmux

tmux Setup

Neo Code works inside tmux, but tmux strips modifier information from certain

Neo Code

Neosantara-first AI coding agent for your terminal.

Product

  • Docs
  • Pricing
  • GitHub

Neosantara

  • Dashboard
  • API

Legal

  • Terms
  • Privacy

2026 Neosantara. All rights reserved.