KlaatCode 2.5.0

KlaatCode 2.5.0

The release where the agent stops grepping around your project and starts knowing it.

Added

• Code graph, everywhere. Your project is indexed into a local code graph (tree-sitter quality, all plans including free) and the agent navigates with it: project_graph_query answers "where is X / what calls Y" with exact file:line, file_outline reads a file's structure for ~10% of the tokens, read_file symbol="Name" serves exactly one definition, impact_check shows the blast radius before an edit, and plan_exploration returns the optimal read order for a task. /graph opens an interactive force-graph of the whole project in your browser.
• Cross-session memory — the agent learns you. A background pass distills durable facts into ~/.klaatai/memory/: project memory (commands that worked, conventions, decisions, corrections) and user memory (how you like to work). Both load at session start, so the next session already knows "uses bun not npm" and never repeats a correction you already made. /memory views, /memory graph renders your persona as a graph. Shared with the VS Code extension — teach the terminal, the editor remembers.
• Skills — reusable playbooks with progressive disclosure. Drop a SKILL.md in .klaatai/skills/<name>/ (project) or ~/.klaatai/skills/ (global): only name + description ride in the prompt; the body loads on demand. Invoke with /<name> [args], create with /skill new. Interops with the open skills ecosystem (npx skills add <repo>, .agents/skills/, Claude Code .claude/skills/).

Fixed

• Windows, seriously. Shell sites use cmd.exe instead of spawning a nonexistent sh; grep is in-process (a missing grep binary can no longer masquerade as "No matches found"); the write sandbox no longer misjudges cross-drive paths; protected system paths are properly refused.
• Compaction correctness. The post-compaction tail can no longer start with orphaned tool results, and every compaction summary carries a cumulative list of files touched — after any number of compactions the agent still knows every file it worked on all session.
• Stuck text and garbled UI. Wide (CJK/emoji) glyphs no longer leave stuck fragments on screen; skill invocations show a compact /name line instead of dumping the playbook into the transcript.
• Graph queries answer natural language — multi-word queries fall back to per-keyword scoring instead of one exact-phrase match that found nothing.
• Honest reads — one read_file returns up to 1000 lines; duplicate overlapping reads are short-circuited with an honest notice.

Full history: CHANGELOG.md

Install

macOS / Linux

curl -fsSL https://klaatai.com/api/install | bash

Windows (PowerShell)

irm https://klaatai.com/api/install-windows | iex

Homebrew

brew install KlaatAI/klaatcode/klaatcode

npm (Node ≥ 18 or Bun ≥ 1)

npm install -g klaatcode

The attached binaries are the exact artifacts the installers serve — each archive contains a single klaatcode binary (klaatcode.exe on Windows).

Usage

klaatcode                   # open in current directory
klaatcode /path/to/project  # open a specific project
klaatcode run "fix types"   # headless / CI mode