Skip to content

Latest commit

 

History

29 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Nexus

The most complete open-source AI coding agent engine. Hybrid local + cloud, multi-agent orchestration, adaptive learning, research-backed prompt optimization, full MCP integration, and 8 AI engines — from local Ollama to Claude Opus.

Ships in sentinel-cli as sentinel nexus.

What Makes Nexus Different

Feature Nexus Claude Code Cursor Devin
Multi-engine (8 AI backends)
Local/private AI (Ollama)
Multi-agent orchestration
Adaptive per-project learning
Smart model delegation (cowork)
Research-backed prompt optimization
Full MCP client + 25 servers
Knowledge graph of codebase
Self-evaluation + auto-retry
Plugin system
Response cache + context squeeze
Live cost meter + /undo
Security scanner built-in
Git intelligence (ownership, velocity)
Autonomous /loop with goal tracking

Architecture

┌──────────────────────────── N E X U S ────────────────────────────┐
│                                                                    │
│  INPUT LAYER                                                       │
│  ├─ Intent Router        classify → route to optimal handler       │
│  ├─ Reasoning Engine     4 structured thinking modes               │
│  └─ Adaptive Learner     gets smarter per-project over time        │
│                                                                    │
│  PLANNING LAYER                                                    │
│  ├─ Agentic Planner      dependency-aware task graphs              │
│  ├─ Workspace Intel      auto-detect stack, framework, conventions │
│  └─ Cowork Engine        delegate easy tasks to cheap/fast models  │
│                                                                    │
│  EXECUTION LAYER                                                   │
│  ├─ Multi-Agent          fan-out · debate · pipeline · review-loop │
│  ├─ Secure Sandbox       blocked patterns, warnings, audit trail   │
│  ├─ Codemod Engine       rename, update imports, extract, rollback │
│  ├─ Code Actions         docs, dead code, security scan, endpoints │
│  └─ Error Recovery       classify → retry → backoff → escalate    │
│                                                                    │
│  CONTEXT LAYER                                                     │
│  ├─ Prompt Engine        attention-optimal structuring, CoT, MCP   │
│  ├─ Context Engine       auto-gather files, git, memories, TODOs   │
│  ├─ Knowledge Graph      code entities + relationships graph       │
│  ├─ Session Manager      persist, compress, resume across restarts │
│  └─ MCP Bridge           full JSON-RPC client (2025-06-18 spec)    │
│                                                                    │
│  QUALITY LAYER                                                     │
│  ├─ Self-Eval Engine     grade output, auto-retry below threshold  │
│  ├─ Code Review (auto)   security + bugs + perf + style rules      │
│  ├─ Code Radar           complexity hotspots, tech debt map        │
│  └─ Smart Test Gen       structure-aware test generation           │
│                                                                    │
│  OPS LAYER                                                         │
│  ├─ Telemetry            duration, tokens, cost, quality tracking  │
│  ├─ Git Intelligence     ownership, velocity, merge risk, commit   │
│  ├─ Cost Saver           dedup, cache, squeeze (10-30% savings)    │
│  ├─ Background Jobs      async commands without blocking           │
│  └─ Diff Explainer       semantic diff → human explanation         │
│                                                                    │
│  EXTENSION LAYER                                                   │
│  ├─ Plugin System        custom tools, commands, hooks, intents    │
│  ├─ MCP Catalog          25+ servers, 6 bundled by default         │
│  ├─ Project Bootstrap    scaffolds with CI/CD, tests, security     │
│  └─ 8 AI Engines         Claude · Gemini · Codex · Ollama · more  │
│                                                                    │
│  52 modules · 9,627 lines · 115 tests · 100% tested                           │
└────────────────────────────────────────────────────────────────────┘

Engines

Engine Kind Context Models
Claude Code Stream (rich) 200K opus, sonnet, haiku, fable
Gemini CLI CLI (JSON) 1M gemini-2.5-pro, gemini-2.5-flash
Codex CLI CLI (JSON) 272K gpt-5-codex, gpt-5, o4-mini
OpenCode CLI 200K any configured
Aider CLI 200K any configured
Ollama (local) In-process 8-32K any local model
Any OpenAI-compat API varies OpenRouter, Groq, DeepSeek, vLLM...
Anthropic API API 200K claude-* (native, in-process)

Quick Start

sentinel nexus "fix the login bug"
sentinel nexus --engine ollama "explain this codebase"
sentinel nexus run "build a REST API with auth"
sentinel nexus agents "add tests" "write docs" "fix lint"
sentinel nexus --engine hybrid "refactor auth module"  # smart delegation

License

See LICENSE.

About

Nexus -- multi-engine AI coding and security agent with Claude, GPT, Gemini, Ollama support. Planning, cost tracking, 34 modules, and autonomous task execution.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages