kortext

library3.0.0jsnpmunverified

Autonomous AI agent runtime for orchestrating multi-agent software development workflows. v3.0.0 is the current stable release, featuring a TypeScript runtime with Express 5 backend, React 19 + Tailwind v4 dashboard, and SQLite state store via better-sqlite3. Key differentiators include per-task git worktrees for isolation, blueprint-driven pipeline with approval gates, first-class MCP server support (stdio and SSE), and 263 tests with CI. Requires Node >=22 and Git >=2.30. Suitable for teams using Claude Code, Codex, or Gemini CLI to automate project execution with human-in-the-loop approvals.

ai-ml devtools

npm install kortext

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · KORTEXT

kortext

ai-mljavascriptv3.0.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

kortext CLI

✓ npx kortext init

✗ kortext init without npx (if not globally installed)

Invoke via npx or global install (npm install -g kortext).

MCP server

✓ import { KortextMCPServer } from 'kortext/mcp'

✗ import KortextMCPServer from 'kortext'

MCP server is a separate export path; default export is the runtime class.

Runtime

✓ import { KortextRuntime } from 'kortext'

✗ const KortextRuntime = require('kortext')

Package is ESM-only; CommonJS require not supported.

Install globally, scaffold a project, edit blueprint to approved, and start the runtime with dashboard.

npm install -g kortext mkdir my-product && cd my-product kortext init # Edit workspace/references/blueprint.md, set status: approved kortext serve # Dashboard at http://localhost:5173, backend at http://localhost:3200

Debug

Known issues

breakingNode.js >=22.0.0 required; older versions will fail.

fix

Upgrade Node to 22 or later.

affects: >=3.0.0

breakingGit >=2.30 required for worktree operations; older Git will crash on task creation.

fix

Update Git to 2.30+.

affects: >=3.0.0

gotchaBlueprint must have status: 'approved' in YAML frontmatter to trigger pipeline; draft status does nothing.

fix

Set status to 'approved' in workspace/references/blueprint.md.

affects: >=3.0.0

deprecatedv2 CLI commands (kortext run, kortext plan) removed in v3.

fix

Use kortext start <workflow-id> instead.

affects: >=3.0.0

Errors

Common errors & fixes

Error: Cannot find module 'kortext'

Package not installed or not found in node_modules.

fix

npm install -g kortext or npx kortext ...

error:0308010C:digital envelope routines::unsupported

Node.js too old (below 22).

fix

Upgrade Node.js to version 22 or higher.

Upgrade

Version history

3.0.0latest on npm

Audit

Dependencies

better-sqlite3requiredSQLite state store for runs and workflow data

Agent activity

33 hits · last 30 days

node

Resources

githubhttps://github.com/erayendes/kortext ↗

packagekortext ↗

homepagehttps://github.com/erayendes/kortext#readme ↗