Show HN: TormentNexus – Open-source AI control plane with 26K+ MCP tools

Uh oh!

There was an error while loading. Please reload this page.

Notifications You must be signed in to change notification settings

Fork 2

Star 6

BranchesTags

Open more actions menu

Folders and files

NameName

Last commit message

Last commit date

Latest commit

History

3,135 Commits

3,135 Commits

..go_backup_old

..go_backup_old

.agent/skills/git-advanced

.agent/skills/git-advanced

.aider

.aider

.antigravity

.antigravity

.claude-desktop/extensions/tormentnexus

.claude-desktop/extensions/tormentnexus

.claude

.claude

.cline

.cline

.codewhale

.codewhale

.codex

.codex

.copilot/extensions/tormentnexus

.copilot/extensions/tormentnexus

.cursor

.cursor

.editor-configs

.editor-configs

.gemini

.gemini

.github

.github

.goose/extensions/tormentnexus

.goose/extensions/tormentnexus

.grok

.grok

.hermes

.hermes

.jules/memory

.jules/memory

.kilo

.kilo

.kimi-code

.kimi-code

.mavis

.mavis

.memory

.memory

.opencode

.opencode

.openhands/microagents

.openhands/microagents

.pi

.pi

.roo

.roo

.verdent/skills/tormentnexus

.verdent/skills/tormentnexus

.vscode/extensions/tormentnexus

.vscode/extensions/tormentnexus

.zcode

.zcode

apps

apps

archive

archive

data

data

deploy

deploy

docs

docs

go

go

installer

installer

landing

landing

marketing

marketing

marketing_agent

marketing_agent

npm-package

npm-package

npm/@tormentnexus

npm/@tormentnexus

packages

packages

scripts

scripts

settings

settings

templates

templates

tools/puppeteer

tools/puppeteer

.dockerignore

.dockerignore

.env.example

.env.example

.geminiignore

.geminiignore

.gitattributes

.gitattributes

.gitignore

.gitignore

.tormentnexus_queue.db

.tormentnexus_queue.db

AGENTS.md

AGENTS.md

CHANGELOG.md

CHANGELOG.md

CODE_OF_CONDUCT.md

CODE_OF_CONDUCT.md

CONTRIBUTING.md

CONTRIBUTING.md

DEMO.md

DEMO.md

Dockerfile

Dockerfile

Dockerfile.quick

Dockerfile.quick

GROWTH_ENGINE.md

GROWTH_ENGINE.md

HANDOFF.md

HANDOFF.md

Makefile

Makefile

NEXT_LEVEL.md

NEXT_LEVEL.md

README.md

README.md

ROADMAP.md

ROADMAP.md

SECURITY.md

SECURITY.md

TODO.md

TODO.md

VERSION

VERSION

build.bat

build.bat

convert_pages.py

convert_pages.py

docker-compose.yml

docker-compose.yml

list_dashboard_pages.py

list_dashboard_pages.py

npm-package.json

npm-package.json

package.json

package.json

plan.md

plan.md

plan.txt

plan.txt

pnpm-lock.yaml

pnpm-lock.yaml

pnpm-workspace.yaml

pnpm-workspace.yaml

start.bat

start.bat

start.sh

start.sh

tormentnexus-mcp-server

tormentnexus-mcp-server

tsconfig.base.json

tsconfig.base.json

turbo.json

turbo.json

wails.json

wails.json

Repository files navigation

One-command install: npx @tormentnexus/install

Local-first, open-source AI control plane with persistent multi-tier memory, MCP tool orchestration across 20,000+ servers, multi-agent swarm coordination, and corporate-grade security — all running on your machine.

📄 Read the Technical Whitepaper | 💬 Join Discord

Installation

Quick Start (Windows)

scripts\install.bat

Quick Start (macOS / Linux)

python3 scripts/install-client-support.py

GUI Installer

python3 scripts/install-gui.py

What Gets Installed

The installer detects and configures TormentNexus for 38+ AI coding agents. Each client receives every integration it supports:

Client SKILL MCP CMD HOOK EXT AGENT

Claude Code x x x x - -

Cursor x x x x x -

Windsurf x x x x x -

Gemini x x x - x x

Codex CLI x x x - - -

Grok Build x x x x x -

Antigravity x x - - x x

Aider - x - - - -

CodeWhale x x x x x -

Goose x x x x x -

Pi x x x - x -

Cline / Roo x x x x - -

+ 26 more x x varies varies varies varies

Corporate On-Premises Installation

For enterprises running TormentNexus behind a firewall:

python3 scripts/install-client-support.py --mode corporate scripts\install.bat corporate

Corporate mode adds:

SSO/OIDC configuration for enterprise identity providers

RBAC roles with admin/user/auditor defaults

Audit logging to local SQLite with daily rotation

Multi-tenant isolation for on-premises tenant separation

Enterprise license key setup

Server Deployment

GOOS=linux GOARCH=amd64 go build -o tn-kernel ./cmd/tormentnexus pm2 start tn-kernel --name tn-kernel -- serve -port 8090 -host 127.0.0.1

TormentNexus: The Cognitive Kernel — Universal Open-Source AI Control Plane for Multi-Agent Workflows, MCP Tools & Context-Aware Memory

TormentNexus is a local-first, open-source universal AI control plane and coding harness engineered to give your LLM agents infinite persistent memory, tool orchestration, and autonomous infrastructure assimilation—all running locally on your machine or in production.

🏢 Corporate & Enterprise Deployments (HyperNexus)

For professional, corporate, and enterprise deployments, visit HyperNexus. HyperNexus is the official licensed, certified, authoritative, cloud-hosted corporate installation of the TormentNexus kernel. It provides:

Tenant Isolation: Automated provisioning scripts to spin up per-tenant containers with isolated volumes and resource limits.

Enterprise-Grade Security: Full SSO support and fine-grained Role-Based Access Control (RBAC) middleware.

Air-Gapped & VPC Support: Production-ready deployment configurations with daily audit logs for SIEM integration.

Stripe Billing Integration: Built-in webhook configurations and subscription seats management.

Table of Contents

What It Does

Architecture

Core Pillars

Monorepo Structure

The Go Sidecar

The Dashboard

MCP Ecosystem

Memory & Context

Swarm & Multi-Agent

API Surface

Quick Start

What's Planned

Roadmap

Documentation

Contributing

License

What It Does

TormentNexus is a decision system and universal bridge — not just an aggregator. It runs locally as a modular monolith that unifies the chaotic landscape of AI tools, models, and agents into a single, coherent operating system for AI-driven development.

Current Capabilities (v1.0.0-b1)

Capability Status Details

MCP Registry Stable Infinite tracked MCP servers, unlimited populated in SQLite catalog, infinite verified servers, unlimited verified tools

Native Go Tools Beta Unlimited native Go tool implementations replacing external MCP servers (filesystem, Slack, SQLite, DuckDuckGo, Ollama, TTS, Vercel, NWS, DexPaprika, Firecrawl, Exa, arXiv, Semantic Scholar, Mem0, Alpaca, Alpha Vantage, Hugging Face, Semgrep, Octagon, Browser Automation, ChromaDB, Basic Memory, MindsDB, Serena, AST-grep, PAL, Thoughtbox, and more)

Progressive Tool Routing Stable Semantic vector search + BM25 ranking injects only the most relevant tools into LLM context windows

Dual-Tier Memory Stable L1 (session scratchpad) + L2 (semantic SQLite vault) with heat-score lifecycle and autonomous context harvesting

LLM Waterfall Stable Cascading failover: NVIDIA NIM → OpenRouter → Local LM Studio / Ollama with 429/5xx handling

Multi-Agent Swarm Beta A2A protocol coordination, role rotation (Planner→Implementer→Tester→Critic), consensus engine

Autonomous Healer Stable Diagnose → Fix → Verify → Retry loop with native code execution (tsc, vitest, go test) and L2 vault persistence

Browser Automation Beta Native chromedp handlers: navigate, screenshot, evaluate, click, fill, get HTML

Skill Registry Stable Unlimited assimilated skills from multiple harness ecosystems (Aider, Agent, CCS, Hermes, Pi, etc.) with Jaccard deduplication

CodeWhale Extension Stable Native Rust extension with full Pi extension parity — infinite MCP tools, unlimited custom tools, infinite slash commands, unlimited shortcuts, L2 memory hooks, RBAC, @memory:key expansion, per-turn context harvesting, session compaction

Dashboard Stable Next.js 16 + React 19 + Tailwind CSS 4 with real-time telemetry, knowledge graph, healer view, swarm visualizer

npm Packages Published @tormentnexus/install, @tormentnexus/core, @tormentnexus/cli, @tormentnexus/openhands, @tormentnexus/vscode, @tormentnexus/cursor

tRPC Bridge Stable Type-safe API layer (port 7778) connecting UI to Go sidecar

Session Import Beta Automatic ingestion of Claude, Aider, and other harness session artifacts

Enterprise Licensing Experimental Ed25519-signed license token validation with offline verification

Supervisor Nudge Stable Autonomous Windows UI automation to maintain development momentum across AI chat surfaces

Deep Link Protocol Beta tormentnexus://attach?session=ID and tormentnexus://create?cliType=aider URI handling

Provider Metrics Stable Real-time telemetry tracking for all LLM providers with latency and cost analysis

🚀 One-Command Install

npx @tormentnexus/install

That's it. Detects and configures TormentNexus for 38+ AI coding agents including Claude, Gemini, Cursor, Windsurf, Aider, CodeWhale, and more. Each gets MCP config, skills, hooks, and commands.

CLI tools

npm install -g @tormentnexus/cli tn search "your topic" tn status

OpenHands integration

npx @tormentnexus/openhands

Core kernel

npx @tormentnexus/core

Architecture

TormentNexus is a high-performance Go modular monolith with a TypeScript/Next.js frontend, operating as a local-first control plane.

┌─────────────────────────────────────────────────────────────┐ │ OPERATOR LAYER │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ │ Web Dash │ │ CLI (TS) │ │ VS Code │ │ │ │ Port 7779 │ │ tormentnexus│ │ Extension │ │ │ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │ │ │ │ │ │ │ └────────────────┴────────────────┘ │ │ │ │ │ ┌───────────────────────┴───────────────────────┐ │ │ │ GO SIDECAR (Port 7778) — The Authoritative Kernel │ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ │ SkillStore│ │ EventBus │ │ Vault │ │ Healer │ │ │ │ │ (BM25) │ │ (Swarm) │ │(sqlite) │ │(Immune) │ │ │ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ │ Router │ │ PairOrchestrator│ │ CodeExecutor│ │ MCP Sync │ │ │ │ │(Progressive)│ │(Consensus) │ │(Sandbox) │ │(Registry)│ │ │ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ ┌───────────────────────┴───────────────────────┐ │ │ │ EXTERNAL MODELS & TOOLS │ │ │ │ OpenAI · Anthropic · Gemini · OpenRouter · Ollama │ │ │ 600+ MCP Servers · 3,900+ Native Go Tools │ │ └──────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────────┘

Key Ports

Service Port Purpose

Go Sidecar 7778 Authoritative native kernel (HTTP API + tRPC)

Next.js Dashboard 7779 Web observation deck

Core Pillars

1. Progressive MCP Tool Routing & Parity

Models should never be overwhelmed with a 50,000-token tool dump. TormentNexus employs a multi-layered, progressive disclosure system:

Semantic Search: Local vector embeddings match the active prompt against a global MCP directory of infinite servers.

The Router: Only the top highly relevant tool schemas are injected into the active LLM context.

Universal Parity: Byte-for-byte identical tool signatures for Claude Code, Codex, Gemini CLI, Cursor, and Windsurf.

1. Dual-Tier Memory Architecture (L1 / L2)

Context is finite; memory must be infinite.

L1 — Session Scratchpad: Ephemeral, lightning-fast memory tied directly to the active session.

L2 — The Vault: Permanent semantic storage in SQLite with sqlite-vec. Saves exact transcripts and LLM-compressed heuristics.

Context Harvesting: Every session autonomously queries the L2 Vault to pull in relevant histo

[truncated for AI cost control]