AI coding agent with Plan/Build modes, subagent delegation, skills, and a terminal chat interface.

$ npm install -g @alnyx/klyxor

Requires Node.js 18+. After install, run klyxor in your terminal. Read the docs →

Built for serious workflows

Plan / Build Modes

Plan before you code, or jump straight into building. The agent adapts to your workflow with read-only planning or full-access execution.

Streaming Responses

Real-time token streaming — see responses as they arrive, no waiting for the full answer.

Error Recovery

Smart retry with exponential backoff, rate-limit handling, and fallback model support.

Subagent Delegation

Delegate tasks to nested subagents for parallel execution across the codebase.

Skills System

Loadable .md skills with triggers, dependency resolution, and auto-matching.

MCP Integration

Connect to Model Context Protocol servers. Bridge their tools as native agent tools.

Refactoring Engine

Analyze code, generate refactoring plans, execute with validation. Automatic code quality improvements.

Multi-Agent

Specialized agents for frontend, backend, database, devops, security, testing, docs.

Time Machine

Create snapshots, restore, compare, and branch your codebase.

Predictive Bugs

Pattern-based bug prediction across 25+ categories before they happen.

Token & Cost Tracking

Per-model usage tracking. Use /cost and /tokens to view stats in real time.

Project Context

Auto-loads AGENTS.md / KLYXOR.md / .klyxor/context.md for project awareness.

Git Integration

git_status, git_diff, and git_worktree tools for version control.

Web Fetch

Fetch and read web pages directly from the terminal.

Session Export

Export full chat history to markdown with /export.

Context Compaction

Auto-summarizes long conversations to preserve context.

Env API Keys

API keys via environment variables. Never stored in plain text.

Multi-Provider

Multiple providers, each with multiple models. Switch on the fly.

Update Checker

Auto-checks npm registry for updates on startup.

Up and running in seconds

# Install globally via npm
$ npm install -g @alnyx/klyxor

# Set up a provider
$ klyxor
> /connect openai
> /model gpt-4o

# Or use an environment variable
$ export OPENAI_API_KEY=sk-...
$ klyxor

# One-shot queries
$ klyxor "Write a hello world in Python"
$ klyxor --plan "Design a REST API"

Slash commands

/helpList all commands
/planSwitch to Plan mode
/buildSwitch to Build mode
/model [name]Show or switch model
/connect [name]Connect a provider (provider/model)
/skillsList / create / search skills
/sessions [name]Switch session
/new [name]Create new session
/resetClear current session
/export [path]Export chat to markdown
/compactCompress message history
/costUsage and cost stats
/tokensDetailed per-model breakdown
/toolsList available tools
/mcp listList MCP servers and tools
/mcp connect <name>Connect to MCP server
/mcp disconnect <name>Disconnect MCP server
/updateCheck for klyxor updates
/exitExit

Config structure

~/.klyxor/
+-- config.json# Providers, models, API keys, MCP servers
+-- sessions.json# Session history
+-- skills/# Custom skills (.md)
+-- tools/# Custom tools (.json)
+-- snapshots/# Time Machine snapshots
\-- exports/# Exported chats