DOCUMENTATION
Everything you need to use Neo Code
Getting Started
3 pagesGetting Started
Neo Code is a Neosantara-first AI coding agent that runs in your terminal.
configurationConfiguration
Neo Code uses JSON settings files and a directory structure for configuration.
envEnvironment variables
All environment variables read by Neo Code at runtime. Server-side only —
Core Usage
4 pagesTools
Neo Code exposes tools to the AI model for interacting with your codebase.
sessionsSessions
Neo Code sessions are stored as trees, enabling branching, forking, and
compactionCompaction & Branch Summarization
LLMs have limited context windows. When conversations grow too long, Neo Code
memoryMemory System
Neo Code persists context across sessions using an automatic memory system.
Advanced
4 pagesSubagents
Subagents are parallel workers that handle tasks independently with their own
extensionsExtensions
Extensions are TypeScript modules that extend Neo Code's behavior. They can
skillsSkills
Skills are installable packages that extend Neo Code with specialized
lspCode intelligence (LSP)
Neo Code can use real Language Server Protocol (LSP) servers to navigate code
Reference
2 pagesOther
9 pagesCustom Providers
Extensions can register custom model providers via `neo.registerProvider()`, and
json-modeJSON Event Stream Mode
```bash
keybindingsKeybindings
All keyboard shortcuts can be customized via `~/.neo-code/agent/keybindings.json`.
prompt-templatesPrompt Templates
Prompt templates are Markdown snippets that expand into full prompts. Type
rpcRPC Mode
RPC mode enables headless operation via a JSON protocol over stdin/stdout.
session-formatSession File Format
Sessions are stored as JSONL (JSON Lines) files. Each line is a JSON object with
shell-aliasesShell Aliases
Neo Code runs bash in non-interactive mode (`bash -c`), which doesn't expand
terminal-setupTerminal Setup
Neo Code uses the [Kitty keyboard protocol](https://sw.kovidgoyal.net/kitty/keyboard-protocol/)
tmuxtmux Setup
Neo Code works inside tmux, but tmux strips modifier information from certain