convez.ai
MCP Server
Spitfire-Products

nexus-cortex

Spitfire-Products/nexus-cortex

Ver no GitHub
InicialPluginScore · de 0 a 100

A headless, multi-provider AI agent harness — embed it as a library, script it from the CLI, or run it as a stateful agent server. One orchestrator drives every major LLM provider.

Instalação

$npx convez-ai Spitfire-Products/nexus-cortex

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 1 dia
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

Nexus Cortex

A headless, multi-provider AI agent harness — embed it as a library, script it from the CLI, or run it as a stateful agent server.

npm license node

Nexus Cortex is the engine underneath the agent — not another interactive terminal app, but the harness you build on. One orchestrator drives many models across many providers through a pluggable adapter layer, with sub-agents, MCP, sandboxed artifacts, a permission engine, context management, and append-only session history built in.

Run it three ways: as a library (import { CortexOrchestrator }), as a headless CLI (cortex "…"), or as a stateful HTTP agent server.

Release 1 is the headless harness — core, executors, server, cli. The interactive React/Ink terminal UIs (@nexus-cortex/tui) land in Release 2.

Quick Start

npm install -g nexus-cortex

That's it — the cortex command is now on your PATH. Add at least one provider key: rename .env.example to .env and put a valid LLM key in it (e.g. ANTHROPIC_API_KEY=…).

Then just talk to it — the server auto-starts on first use, no separate step:

# Chat (multi-turn — the session persists across calls)
cortex "What is this project?"
cortex "Now summarize the largest file"

# One-shot autonomous agent in any directory (alias: `cortex run`)
cortex agent --cwd ./my-project "add a --version flag to the CLI and run the tests"

Claude also works with a Claude.ai Pro/Max OAuth subscription instead of an API key — see docs/authentication.md. For advanced .env setup, see docs/configuration.md.

Why Nexus Cortex

  • Every major provider, one harness. The five major labs — Anthropic, OpenAI, Google/Gemini, xAI, and DeepSeek — are proven end-to-end. A dozen more (Cloudflare Workers AI, Zhipu/GLM, Qwen, Moonshot/Kimi, MiniMax, Mercury) are wired through the same adapter layer. 84 models across 11 providers in all — switch mid-session, route from benchmark history, or mix providers across sub-agents. Run cortex models list for the live set.
  • Headless and scriptable by design. No UI required. Pipe JSON, resume sessions by ID, and chain multi-turn agent workflows — the server is a stateful agent, not a stateless endpoint.
  • An embeddable engine, not a closed app. The orchestrator, adapters, 45 built-in tools, and middleware are a clean TypeScript library you build on.
  • A real harness, batteries included. Parallel sub-agents (Task) with per-agent permissions, MCP tool integration, a sandboxed-artifact toolset (run + inspect real web apps), git/PR tooling, a policy-based permission engine, token-budget + prompt-cache context management, and append-only JSONL sessions with file checkpoints.
  • A built-in improvement loop (opt-in). Build a baseline and a candidate, benchmark both on a graded task set, and gate a keep/discard decision with real statistics — driving the harness's own self-improvement (inspired by karpathy/autoresearch).

Documentation

DocWhat's in it
User GuideThe cortex CLI in full, running the HTTP server, the REST API, sessions, PR review, production deployment, troubleshooting
ArchitectureMonorepo layout, the orchestrator, providers, tools, sub-agents, auto-research, and the other core systems
AuthenticationProvider API keys and Claude OAuth setup
ConfigurationEvery environment variable, annotated
Embed the libraryUse @nexus-cortex/core directly in your own code
ChangelogRelease history

Contributing

Contributions welcome — see CONTRIBUTING.md.

License

Apache-2.0 — see LICENSE and NOTICE. Copyright 2026 Spitfire-Products.

Built clean-room as a multi-provider TypeScript agent harness.

Ver o original no GitHub

Bom para

Relacionados