convez.ai
MCP ServerAutomaçãoAvançado
Craigtut

Cortex Agent Framework

Craigtut/cortex-mono

Framework agentic production-grade com context slots e memory compaction

Ver no GitHub
BomPluginScore · de 0 a 100

Framework de agentes de produção com gerenciamento estruturado de contexto e slots nomeados otimizados para cache de prompt. Inclui Cortex Code, um agente de codificação terminal, e suporte nativo a MCP, ferramentas integradas (bash, file ops, web fetch) e múltiplos provedores de IA.

Instalação

$npx convez-ai Craigtut/cortex-mono

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
100%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Criar agentes de IA com controle fino de contexto e cache optimization
  • Construir assistentes de codificação e automação de terminal
  • Integrar múltiplos provedores de LLM com gerenciamento unificado
  • Implementar sistemas com memory compaction e budget guards

Veredito

Cortex é um framework robusto para quem precisa de agentes com arquitetura sofisticada e otimização de contexto em produção. A curva de aprendizado é íngreme, mas oferece controle granular que ferramentas mais simples não proporcionam — ideal para equipes que precisam de estabilidade e eficiência de token em larga escala.

README

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

Cortex

Production-grade agent framework with structured context management. By Animus Labs.

Cortex treats the LLM context window as a managed surface, not a flat chat log. Named slots with stability-ordered layout maximize prompt cache hit rates. Observational memory is the default compaction strategy, with classic string trimming, summarization, and emergency truncation available when needed.

Built on @earendil-works/pi-agent-core for the agentic loop and @earendil-works/pi-ai for model access.

Packages

PackageDescription
@animus-labs/cortexCore agent harness
@animus-labs/cortex-codeTerminal-based coding agent

Getting Started

npm install @animus-labs/cortex

For the terminal coding agent:

npm install -g @animus-labs/cortex-code
cortex
import { CortexAgent, ProviderManager } from '@animus-labs/cortex';

const providers = new ProviderManager();
const model = await providers.resolveModel('anthropic', 'claude-sonnet-4-20250514');

const agent = await CortexAgent.create({
  model,
  workingDirectory: process.cwd(),
  initialBasePrompt: 'You are a helpful assistant.',
  // Optional. If omitted, pi-ai falls back to provider environment variables.
  getApiKey: async (provider) => {
    if (provider === 'anthropic' && process.env.ANTHROPIC_API_KEY) {
      return process.env.ANTHROPIC_API_KEY;
    }
    throw new Error(`No API key configured for ${provider}`);
  },
});

agent.onTurnComplete((output) => {
  if (output.userFacing) console.log(output.userFacing);
});

await agent.prompt('What files are in this directory?');
await agent.destroy();

Key Capabilities

  • Context Slots: Named, stability-ordered content blocks optimized for prompt cache hit rates. Ephemeral context provides per-loop injection without polluting persistent history.
  • Compaction: Observational memory by default, classic microcompaction and summarization available by config
  • Built-in Tools: Bash, TaskOutput, Read, Write, Edit, UndoEdit, Glob, Grep, WebFetch, SubAgent
  • MCP Support: Integrate external tool servers via the Model Context Protocol
  • Skills: Progressive disclosure system for dynamic capability loading
  • Provider Management: Multi-provider support, OAuth where available, API key validation, and custom OpenAI-compatible endpoints
  • Budget Guards: Token and cost limits to prevent runaway execution

Development

Requires Node.js 24+.

# Install dependencies
npm install

# Build all packages
npm run build

# Run tests
npm run test:run

# Type check
npm run typecheck

Documentation

Start with the Cortex consumer guide. Architecture guides, tool references, and integration notes live in docs/cortex/.

License

MIT

Ver o original no GitHub

Bom para

Relacionados