v2.9.0: Per-Project Isolation

Per-Project Isolation

Locked Mode

• /api/projects\ returns \locked: true/false\ based on \CORTEX_SINGLE_PROJECT\
• \POST /api/projects/switch\ returns 403 with helpful message when locked

Dashboard UI

• Projects tab: amber 'Isolated' banner when locked, 'Start new instance' hint
• TopBar: amber 'isolated' lock badge visible when locked
• Project cards: both API and MCP ports shown (activity + network icons)
• Agent badges: running agent count with port shown on active project cards

Bug Fixes

• \�in/cortex.js: SIGTERM handler for clean agent file cleanup
• Server: \listAgents\ imported, \scanProjects\ includes agent list per project
• \useProjectData\ hook: exposes \isolated\ and \project_agents\ fields

v2.8.0 — Full Project Isolation

v2.8.0 — Full Project Isolation

4 fixes to eliminate all project mixing.

Fixes

• Fix 1: CORTEX_SINGLE_PROJECT=1 — dashboard shows only the current project, no parent-dir crawling
• Fix 2: findNextAvailablePort() now increments both api_port AND mcp_port (was only incrementing api_port)
• Fix 3: Per-agent tracking in .cortex/agents/{id}.json — auto-cleanup on exit/SIGINT
• Fix 4: cortex_set_active_project blocked when process started with --project — returns error with hint to start new agent

How multi-agent works now

# Agent 1: aura project on port 3001
cortex start --project ./aura
# → Dashboard: localhost:3001 (aura only)
# → Agent locked to aura, can't switch

# Agent 2: other project on port 3002  
cortex start --project ./other
# → Dashboard: localhost:3002 (other only)
# → Agent locked to other, can't switch

Changelog

• 8 files changed, +94/-35
• npm @neuralnexustech/cortex-mcp@2.8.0

v2.7.0 — Per-Project Isolation

v2.7.0 — Per-Project Isolation

Each project gets its own port. Two agents, two projects, zero mixing.

What's new

• .cortex/config.json — stores api_port + mcp_port per project
• Port registry at ~/.cortex/ports.json tracks all assigned ports
• cortex init assigns next available port automatically (3001, 3002, 3003...)
• cortex start/dashboard reads port from project config — no more hardcoded ports
• /api/projects shows port for each project
• Projects tab shows API port per project card
• Dashboard only shows current project data — no mixing

How it works

Agent 1: cortex start --project ./aura     → port 3001 (aura data only)
Agent 2: cortex start --project ./other    → port 3002 (other data only)
Each agent sees only its own project's features, files, tests, pipeline

Changelog

• 40 files changed, +149/-48
• npm @neuralnexustech/cortex-mcp@2.7.0

v2.6.0 — Multi-Project Tab + Switcher

v2.6.0 — Multi-Project Tab + Switcher

No more mixing. Each project is fully isolated — each has its own .cortex/cortex.db, features, files, and tests. Switch between them with one click.

What's new

• Projects tab — see all discovered cortex projects as cards with name/goal/stack/counts + Switch button
• GET /api/projects — scans parent directories for .cortex/cortex.db, reads project info from each
• POST /api/projects/switch — switch active project (closes old DB, opens new, watcher auto-updates)
• /state returns projects_current + projects_available — dashboard always knows which project is active
• TopBar — project name is clickable, links to Projects tab
• Sidebar — new Projects nav item with Layers icon
• API server PROJECT_PATH now dynamic — changes at runtime when switching projects
• DB watcher — auto-updates to watch the new project's database on switch
• WebSocket event — project_switched fires on switch

How it works

Dashboard → /api/projects → scans .cortex/cortex.db up to 5 parent dirs
User clicks Switch → POST /api/projects/switch → closes old DB → opens new DB
Dashboard reloads → new project data loads → clean separation

Changelog

• 53 files changed, +502/-240
• npm @neuralnexustech/cortex-mcp@2.6.0

v2.5.0 – Audit Fix: 0 Missing Tests

v2.5.0 – Audit Fix: 0 Missing Tests

Health check now reports 0 files missing tests (was 12). Every source file has a registered test with proper linkage.

What's new

• cortex_tick_file now accepts optional test_id parameter to link files to tests at creation time
• tickFile UPDATE query now persists test_id (previously only INSERT did)
• PATCH /api/files/:id/link-test REST endpoint for linking files to tests
• 12 vitest test stubs created in tests/ directory — one per source file
• 12 new cortex tests registered and passed
• All 12 file_tree records now have test_id set (health check no longer flags them)

Changelog

• 18 files changed, +103/-3
• npm @neuralnexustech/cortex-mcp@2.5.0

v2.4.0 – Autonomous Pipeline System

Autonomous Pipeline System

Click Start on the Pipeline tab — the planner breaks any goal into ordered tasks, then auto-executes them with live progress.

What's new

• Planner — natural language goal → DAG of ordered tasks (setup → implement → test → verify)
• Executor — auto-executes each task, retries failures up to 3×
• Loop controller — pause/resume/cancel with WebSocket live push
• Auto-heal — detects broken files, restores from checkpoint, resets failed tests
• 8 new MCP tools: cortex_pipeline_start, cortex_pipeline_status, cortex_pipeline_pause, cortex_pipeline_resume, cortex_pipeline_cancel, cortex_pipeline_plan, cortex_auto_heal, cortex_pipeline_history
• Dashboard Pipeline tab — goal input, active pipeline card (progress bar, controls, task list), history
• WebSocket events — pipeline_started, pipeline_running, pipeline_paused, pipeline_resumed, pipeline_cancelled, pipeline_retrying, pipeline_task_*
• Live pipeline data in /state endpoint

Full changelog

• 49 files changed, +1300/-91

v2.3.0: Light Theme Dashboard Redesign

Dashboard Light Theme Redesign

New Design

• Modern white/gray background with soft shadows
• Purple/violet accent colors
• Circle checkboxes (round, not square)
• Task-board todo list style for Overview
• Collapsible status groups with colored dots
• Strikethrough animation for completed items
• Soft pastel badges (green, orange, red, purple)
• White sidebar with purple active state
• Frosted glass topbar with notification bell

Components Updated

• All 15 shadcn/ui components restyled
• LoadingSkeleton, ErrorBoundary, GlobalSearch
• Sidebar, TopBar, AppLayout
• Overview tab with task-board layout

Install

\\�ash
npx @neuralnexustech/cortex-mcp@latest

or

npm install -g @neuralnexustech/cortex-mcp@latest
\\

Links

• npm: https://www.npmjs.com/package/@neuralnexustech/cortex-mcp
• GitHub: https://github.com/neuralnexustech/cortex-mcp
• Website: https://neuralnexustech.com/

Cortex MCP v2.2.0

Cortex MCP v2.2.0

Dashboard full rebuild with proper UI components, data tables, and modern architecture.

What's New

Dashboard Architecture

• Zustand state management — no prop drilling
• React Query — caching, background refetch, optimistic updates
• WebSocket auto-reconnect — exponential backoff (1s → 30s)
• ErrorBoundary per tab — one tab crashes, others survive
• Tab persistence — localStorage remembers last active tab

New UI Components

• Table — sortable, with header/body/rows/cells
• Checkbox — Radix UI with cyan check
• Input — styled with focus ring
• Label, Avatar, Alert (4 variants)

Tabs Rebuilt with Data Tables

• Features: search, sort, select all, bulk actions
• FileTree: expandable rows, dictionary status
• Tests: status icons, filter tabs (all/passed/failed/pending)
• Issues: checkboxes, status icons, filter tabs
• Dictionary: expandable rows, word count, search
• Progress: timeline dots, agent badges
• Library: tabs for snippets/decisions
• Research: table with source links
• Settings: tables for project info, data summary
• Overview: stat cards with change indicators, progress bars, activity table
• Graph: glow filter, legend panel, selected node detail

Performance

• Main bundle: 234KB (was 400KB)
• Lazy-loaded tab chunks (2-7KB each)
• IntersectionObserver + visibilitychange polling

Install

npx (recommended)

{
  "mcp": {
    "cortex": {
      "type": "local",
      "command": ["npx", "-y", "@neuralnexustech/cortex-mcp@latest", "start", "--project", "."],
      "enabled": true,
      "env": { "CORTEX_PROJECT_PATH": "." }
    }
  }
}

npm

npm install -g @neuralnexustech/cortex-mcp@latest

Links

• Website
• GitHub
• npm

License

MIT