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 →

Capabilities

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.

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.

Todo Lists

The agent creates and tracks tasks inside the session. All changes visible in chat.

Retry + Backoff

Automatic retry on LLM failures with exponential backoff.

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 into the system prompt for seamless project awareness.

Git Integration

git_status and git_diff tools for working with repositories.

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 when messages pile up.

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.

Get Started

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"
Commands

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
/exitExit
Configuration

Config structure

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