NGODEAI CLI
Autonomous Agentic Coding CLI with System One Decision Intelligence, ultra-fast Rust Core (~80,000 LOC), and complete tool sovereignty in your terminal.
bun add -g @ngodeai/coding-agentRequires Bun runtime (>= 1.1). Installs the sovereign binary globally as ngodeai.
ngodeaiAutonomous Agentic Coding CLI with System One Decision Intelligence...
Live Differential Terminal UI (TUI)
Workspace Sovereignty in the Terminal
NgodeAI CLI renders directly into your terminal screen using an optimized differential buffer. Every interaction preserves scrollback history without ANSI artifacts or rendering tears.
Hairline frame styling with precise corner ticks keeps output structured and readable during dense code inspections.
Right-hand HUD displays active tasks, context tokens, git branch diff status, model provider, and decision confidence.
Dispatches background workers (scout, reviewer) that report back asynchronously without polluting main conversational context.
Six Decoupled Architectural Layers
Terminal & Presentation Layer
UI & InteractionProvides frictionless developer interaction with true zero-flicker rendering, ANSI/SGR mouse handling, strict brand-box aesthetics (`▪───▪`), and persistent live status telemetry.
Agent Orchestration Core
ReAct & State MachineAutonomous reasoning engine that executes multi-step plans without compounding hallucinated context. Manages execution barriers, subagent swarms, and turn recovery.
Jev Engineering Decision Brain
System One IntelligenceConverts application states into typed decisions in milliseconds. Eliminates prompt bloat by routing micro-choices away from expensive generative LLMs into calibrated decision models.
Tool System & Execution Engine
Sovereign Workstation ToolsProduction-grade execution primitives designed for direct terminal power: surgical hashline patches, persistent PTY streaming, and isolated parallel subagents.
Native Rust Acceleration Core
crates/ EngineNative performance layer compiled in Rust. Bypasses Node/V8 overhead for compute-intensive tasks like SIMD line matching, regex grep, AST parsing, and token counting.
LLM & Model Gateway
System Two SynthesisHigh-throughput model gateway connecting the agent directly to best-in-class generative models with unified streaming, thinking effort controls, and zero markup.
Jev Engineering: The 100x Decision Paradigm
Stop Asking Generative LLMs to Make Micro-Decisions
Traditional agentic workflows force an expensive, slow generative LLM to answer every micro-question ("Should I open this file?", "Is this hit relevant?", "Should I ask the user for confirmation?") inside conversational prompt context. This causes severe prompt bloat, high token costs, and compounding reasoning drift.
System One models (mercury-decide, jev-1.14) output calibrated numerical distributions in milliseconds. System Two (Gemini, Claude) is reserved solely for complex code generation.
Workspace state (goals, rules, candidate files) is serialized into typed JSON inputs. Jev evaluates all options concurrently in a single call and returns calibrated probability distribution bars.
Rigorous probability thresholds according to action risk: read >= 0.70, write >= 0.85, and irreversible actions require human confirmation.
Predictions are continually verified against actual outcomes. If code execution disagrees with an approved action, a divergence conflict is recorded in the SQLite ledger (/decisions conflicts).
High-frequency checks run with zero token cost (Rp 0 / $0.00000 Free Tier) on mercury-decide, preserving 100% of your LLM context window for code.
Hardened Engineering Features
Native Rust Performance
SIMD line search, ripgrep regex engine, git tree inspection, and directory traversal running natively in Rust via @ngodeai/natives.
60+ AI Model Providers
Built-in zero-latency support for Google Gemini (3.8 Flash / 2.5), Anthropic Claude, OpenAI, DeepSeek, Groq, Cerebras, OpenRouter, and local Ollama/vLLM endpoints.
Tagged Hashline Surgical Edits
Edits are pinned with cryptographic tags and verified with AST syntax checks — eliminating line drift, duplicate code insertions, and corrupted git diffs.
Parallel Subagent Swarms
Spawn specialized independent workers (scout for read-only exploration, reviewer for code audits, task for execution) that report back without context bloat.
Differential Terminal UI
Custom rendering with clean scrollback preservation, SGR mouse interaction, zero redraw flicker, and distinct ▪───▪ box frames.
Built-In LSP & DAP Protocols
Native code intelligence across TypeScript, Python, Rust, Go, C++, and Java — resolving symbol definitions, references, hover types, and debugging breakpoints.
Practical Usage Examples
Launch the full interactive differential terminal interface inside any project directory.
ngodeai
▪─────────────────────────────────────────────────────────────────────────────▪ │ NgodeAI CLI v1.0.8 │ Model: gemini-3.8-flash │ Decisions: mercury-decide │ ▪─────────────────────────────────────────────────────────────────────────────▪ > Working directory: /workspace/project (branch: main) > Jev Decision Brain: ONLINE (Thresholds: R>=0.70, W>=0.85) [01/03] Discovery Phase [x] Scouted 14 source files across src/modules/ [x] AST index generated in 4.2ms (Rust SIMD) [02/03] Implementation Phase -> Editing src/modules/auth.ts (tag #A1F4) [approved: 0.94]
Built-in Hardened Tool Suite
| Tool | Engine / Backend | Decision Gating Matrix | Capability & Scope |
|---|---|---|---|
| $read | Rust SIMD + Native VFS | Confidence >= 0.70 | Range-aware reader for source code, images, PDF documents, archives, and SQLite tables. |
| $edit | Tree-sitter AST + Rust | Confidence >= 0.85 | Surgical hashline patcher with cryptographic snapshot tags and collision detection. |
| $write | Rust Native VFS | Confidence >= 0.85 | Atomic file writer and new module generator with zero destructive overwrites. |
| $bash | Persistent PTY Daemon | Confidence >= 0.85 | Persistent shell execution with PTY support, job streaming, and background process control. |
| $grep | Ripgrep Regex Engine | Auto-Approved | Ultra-fast regex search backed by the native Rust ripgrep engine with multiline parsing. |
| $glob | Rust Directory Walk | Auto-Approved | Gitignore-aware, high-speed file tree exploration with depth controls. |
| $task | ReAct Swarm Coordinator | Confidence >= 0.85 | Spawns parallel worker subagents (scout, reviewer, task) for deep multi-file execution. |
| $eval | Bun / Python Subprocess | Confidence >= 0.85 | Sandboxed Python and JavaScript (Bun) REPL for scratchpad calculations and scripts. |
| $todo | In-Memory State Machine | Auto-Approved | Deterministic phased task tracker for complex multi-step execution state machines. |
| $ask | Differential TUI Prompt | Human Gated (1.00) | Interactive human-in-the-loop clarification dialog with gated decision recording. |
Local-First State & Environment
Global CLI configuration, default model selection, reasoning budget, and tool permissions.
High-speed SQLite database storing every Jev decision score, confidence bar, and post-hoc conflict record.
Session histories, turn checkpoints, compressed recaps, and token telemetry logs.
Daily rotating audit logs, stream buffers, and background daemon telemetry.
| Variable | Scope / Provider |
|---|---|
| NGODEAI_API_KEY | Primary API key for NgodeAI Gateway & free Jev decision models. |
| GEMINI_API_KEY / GOOGLE_API_KEY | Direct API key for Google Gemini 3.8 Flash & 2.5 Pro. |
| ANTHROPIC_API_KEY | Direct API key for Anthropic Claude 3.7 & 3.5 Sonnet. |
| OPENAI_API_KEY | Direct API key for OpenAI GPT-4o, o3-mini, and o1. |
| DEEPSEEK_API_KEY | Direct API key for DeepSeek V3 and DeepSeek R1. |
| NGODEAI_CONFIG_DIR | Custom directory path (defaults to ~/.ngodeai). |
| NGODEAI_PROFILE | Named configuration profile to activate per project. |
Monorepo Crates & Packages
NgodeAI-CLI/ ├── packages/ │ ├── coding-agent/ # Core CLI entrypoint, commands, and runtime orchestration │ ├── ai/ # Multi-provider LLM client, streaming, and native decision wires │ ├── catalog/ # Model registry, provider descriptors, and KDL compat rules │ └── agent/ # Autonomous agent state machine and execution loop ├── crates/ │ ├── ngode-natives/ # Rust crate for SIMD search, ripgrep, and git inspection │ ├── ngode-builtins/ # Embedded shell tools and cross-platform POSIX utilities │ ├── ngode-ast/ # Tree-sitter AST queries and code structure extractors │ ├── ngode-vfs/ # Virtual and sandboxed filesystem abstraction │ └── ngode-predict/ # Speculative local inference and fast tokenization └── assets/ # Brand visual assets, icons, and architecture diagrams
NgodeAI CLI is open-source software licensed under the MIT License. NgodeAI is derived from and builds upon the foundational architecture of Oh My Pi (OMP), originally created by Stencil Labs, Inc. and Mario Zechner under the MIT License.
Copyright (c) 2026 NgodeAI (https://ngodeai.net)
Copyright (c) 2024-2026 Stencil Labs, Inc. (https://stencil.so)
Copyright (c) 2024-2026 Mario Zechner