Neo Code

A Neosantara-first AI coding agent that runs in your terminal. Cross-session memory, code intelligence, subagents, and 12+ built-in tools.

curl -fsSL https://code.neosantara.xyz/install.sh | sh
neo login

Website: code.neosantara.xyz Docs: code.neosantara.xyz/docs

Features

• Cross-session memory with auto-extraction
• LSP-powered code intelligence (TypeScript, Python, Go, Rust, Java, Ruby, C/C++)
• Subagent delegation for parallel tasks
• MCP server integration
• Auto-compaction for long sessions
• Session tree with fork/clone/resume
• Background shell tasks
• Code review (/review)
• Installable skills and extensions
• Full theming system
• Termux (Android) first-class support

Install

macOS / Linux:

curl -fsSL https://code.neosantara.xyz/install.sh | sh

Termux (Android):

pkg install nodejs-lts git
curl -fsSL https://code.neosantara.xyz/install.sh | sh

From source:

git clone https://github.com/neosantara-xyz/neo-code.git
cd neo-code
npm install --ignore-scripts
npm run build
npm link --workspace @neosantara/code

Packages

Package	Purpose
@neosantara/ai	OpenAI-compatible transport for Neosantara
@neosantara/code	neo CLI/TUI coding agent
@neosantara/agent-core	Agent loop/runtime primitives
@neosantara/tui	Terminal UI primitives
@neosantara/web	Landing page and docs (static export)

Development

npm install --ignore-scripts
npm run build
npm run check    # lint + typecheck (no tests)
npm test         # run tests

Environment variables: docs/env.md

Documentation

• Getting Started
• Configuration
• Tools
• Sessions
• Subagents
• Extensions
• Themes
• Memory
• Skills
• LSP
• Termux
• Environment Variables

Acknowledgments

Neo Code builds upon the work of these open source projects:

• Pi by Earendil Works — terminal coding agent architecture, extension system, and TUI framework
• Codex CLI by OpenAI — agent loop patterns and device auth flow
• Claude Code — reference implementation for AI coding agents

License

MIT