← All docs

DOCS

  1. Getting Started
  2. Configuration
  3. Tools
  4. Sessions
  5. Compaction & Branch Summarization
  6. Subagents
  7. Extensions
  8. Themes
  9. Memory System
  10. Skills
  11. Code intelligence (LSP)
  12. Termux Support
  13. Environment variables
  14. Custom Providers
  15. JSON Event Stream Mode
  16. Keybindings
  17. Prompt Templates
  18. RPC Mode
  19. Session File Format
  20. Shell Aliases
  21. Terminal Setup
  22. tmux Setup
DOCS
  1. Getting Started
  2. Configuration
  3. Tools
  4. Sessions
  5. Compaction & Branch Summarization
  6. Subagents
  7. Extensions
  8. Themes
  9. Memory System
  10. Skills
  11. Code intelligence (LSP)
  12. Termux Support
  13. Environment variables
  14. Custom Providers
  15. JSON Event Stream Mode
  16. Keybindings
  17. Prompt Templates
  18. RPC Mode
  19. Session File Format
  20. Shell Aliases
  21. Terminal Setup
  22. tmux Setup
ON THIS PAGE
  1. Built-in Themes
  2. Custom Themes
  3. Color Categories
  4. Configuration

Themes

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

#Built-in Themes

  • dark (default)
  • light
  • neosantara
  • neosantara-light

Switch with /settings → theme, or --theme <name>.

#Custom Themes

Create JSON files in ~/.neo-code/agent/themes/ or .neo-code/themes/:

{
  "name": "my-theme",
  "vars": {
    "bg": "#1a1a2e",
    "fg": "#e0e0e0",
    "accent": "#00d4aa"
  },
  "colors": {
    "background": "$bg",
    "foreground": "$fg",
    "primary": "$accent",
    "border": "#333355",
    "toolRunning": "#ffaa00",
    "toolDone": "#00cc66",
    "diffAdded": "#00ff88",
    "diffRemoved": "#ff4466",
    "thinkingBorder": "#6644cc"
  }
}

#Color Categories

  • Core UI — background, foreground, primary, border, selection
  • Markdown — headings, code, links, lists, blockquotes
  • Tool Diffs — added, removed, context, header
  • Syntax — keywords, strings, comments, numbers, types
  • Thinking — border colors per thinking level
  • Status — success, warning, error, info

#Configuration

KeyDescription
themeActive theme name
themesAdditional theme file paths to load

CLI flags: --theme <path>, --no-themes

Themes hot-reload via /reload.

ON THIS PAGE

  1. Built-in Themes
  2. Custom Themes
  3. Color Categories
  4. Configuration
Previous← ExtensionsNextMemory System →

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.