← 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. Credentials
  2. Coding-agent runtime
  3. TUI debug
  4. Where flags are read

Environment variables

All environment variables read by Neo Code at runtime. Server-side only — nothing here should be exposed to a browser. A starter .env.example lives at the repo root.

#Credentials

VariableUsed byDefault
NEOSANTARA_API_KEY@neosantara/ai transports, coding-agent fallback resolverrequired
NEOSANTARA_API_BASE_URLneo login device flow, API base URLhttps://api.neosantara.xyz
NEO_CODE_NEOSANTARA_API_BASE_URLFallback for NEOSANTARA_API_BASE_URL inside the CLIfalls back to NEOSANTARA_API_BASE_URL

#Coding-agent runtime

VariableEffect
NEO_CODE_CODING_AGENT_DIROverride the agent config dir (default: ~/.neo-code/agent).
NEO_CODE_CODING_AGENT_SESSION_DIROverride session storage dir; superseded by --session-dir.
NEO_CODE_PACKAGE_DIROverride the package dir; useful for Nix/Guix store paths.
NEO_CODE_SHARE_VIEWER_URLBase URL for /share (default: https://app.neosantara.xyz/session/).
NEO_CODE_OFFLINEDisable startup network ops (1/true/yes). Same as --offline.
NEO_CODE_SKIP_VERSION_CHECKSkip the version-check probe on startup.
NEO_CODE_TELEMETRYForce-enable (1/true/yes) or disable (0/false/no) install telemetry.
NEO_CODE_CACHE_RETENTIONSet to long to opt-in to 24h prompt cache retention where supported.
NEO_CODE_STARTUP_BENCHMARKForce a startup benchmark output (interactive mode only).
NEO_CODE_TIMINGEnable timing instrumentation (1).
NEO_CODE_INSTALLER_URLOverride installer URL for self-update.

#TUI debug

VariableEffect
NEO_CODE_HARDWARE_CURSORShow hardware cursor position.
NEO_CODE_CLEAR_ON_SHRINKRe-render to clear empty rows when content shrinks.
NEO_CODE_DEBUG_REDRAWLog redraw reasons to stderr.
NEO_CODE_TUI_DEBUGDump TUI buffers to /tmp/tui for inspection.

#Where flags are read

The @neosantara/ai package exposes accessors in packages/ai/src/env-flags.ts. Coding-agent reads the rest from packages/coding-agent/src/config.ts and packages/coding-agent/src/main.ts. When you start reading a new flag, add it to one of those files (or to env-flags.ts if it belongs in the AI layer) instead of sprinkling process.env.NEO_CODE_* reads across the codebase.

ON THIS PAGE

  1. Credentials
  2. Coding-agent runtime
  3. TUI debug
  4. Where flags are read
Previous← Termux SupportNextCustom Providers →

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.