DocsChangelog

Project

Changelog

Track the evolution of Krnl Code. All notable changes are documented here in chronological order.

major minor patch
v2.4.0majorJuly 25, 2026

Cross-encoder reranker, tool output filtering, diff viewer, and session management overhaul.

New features

  • Cross-Encoder Rerankerneural reranking of retrieval results using query-document pairs for significantly improved relevance ranking and context quality
  • Tool Output Filteringprevents tool execution output from leaking into assistant messages, keeping responses clean and focused
  • Diff Viewerside-by-side diff comparison with line numbers, markers, and syntax highlighting for reviewing file changes
  • Sidebar File Treeintegrated file explorer in the sidebar for quick workspace navigation
  • Todo Paneltask tracking panel with checklist management for multi-step workflows
  • Worktree Panelvisual worktree management for branch-based development workflows

Improvements

  • Session Handling Refactorconsolidated session management with unified session API and simplified cache synchronization
  • Reranker Model Preloadingcross-encoder model preloads in background and checks cache status before first use
  • Sidebar Recent Sessionsimproved recent sessions display with better metadata and relative timestamps
  • Schedules Enhancementexpanded scheduler functionality with improved job management and SSH remote execution support
  • Server API Expansionenhanced WebSocket server with additional endpoints for session management and retrieval operations
  • Extension Auth Refactorsimplified authentication module using shared library for credential management

Bug fixes

  • Fixed retrieval chunker dropping short chunks that contained important context
  • Fixed embeddings database not properly handling concurrent access during indexing
  • Fixed session cache synchronization leaving stale entries after profile switches
  • Fixed extension not properly detecting workspace changes during active sessions
v2.3.7minorJuly 17, 2026

Memory provider plugins, multi-agent coordination, and release pipeline migration to GitHub Releases.

New features

  • Memory Provider Plugin Systempluggable memory backends (SQLite, JSON, custom registries) with automatic discovery, runtime switching, and per-profile isolation
  • Multi-Agent Task Coordinationcoordinate multiple agent profiles working simultaneously on interdependent tasks with structured handoff protocol and status tracking
  • MCP Tool Categoriesorganized tool catalog with search, favorites, recently-used tracking, and per-server environment variable configuration
  • Custom Slash Commandsdefine project-specific slash commands via .krnl/commands/*.md with $ARGUMENT substitution and inline execution
  • Kanban Board Enhancementdrag-and-drop columns, task assignment, priority levels, tenant isolation, and triage queue support

Improvements

  • Release Pipeline Migrationreplaced actions/upload-artifact with direct GitHub Releases uploads to eliminate artifact storage quota limits
  • Extension Iconupdated extension marketplace and activity bar icon to new KrnlCode branding
  • README Accuracyfixed desktop download filenames to match actual electron-builder output

Bug fixes

  • Fixed TypeScript build errors in desktop app (undo_file, undo_hunk message types missing from KrnlOutgoingMessage)
  • Fixed KrnlAPI.onFilesChanged missing from preload type definitions
  • Fixed useChatIPC test missing required setStatusMessage property
  • Fixed HistoryRow useEffect not returning on all code paths
v2.3.6patchJuly 17, 2026

Prewarm reliability and extension connection fixes.

Improvements

  • Proactive Prewarmworkspace loads in the background on startup; chat input shows a loading indicator during prewarm so the first message is never blocked by cold-start latency
  • Extension Pre-warmingextension now starts backend and loads workspace before you send your first message

Bug fixes

  • Fixed extension not connecting to backend after desktop app restart
  • Fixed prewarm request failing silently when backend process was not yet ready
  • Fixed chat input remaining blocked during workspace initialization
v2.3.5patchJuly 16, 2026

Minor bug fixes and stability improvements.

Bug fixes

  • Fixed scheduler cron parsing failing on short-form intervals ('5m', '1h')now correctly parses minute/hour/second shorthand
  • Fixed Kanban IPC handlers throwing when Python CLI is unavailablenow gracefully falls back to local JSON storage
  • Fixed cron job IPC handlers returning raw objects instead of structured { success, error } responses
  • Fixed chat UI showing raw internal status messages (graph DB info, thinking step labels) as textnow shows loading spinner instead
  • Fixed scheduler executeJobFn hijacking the main chat WebSocket connectionnow uses direct HTTP API calls to the backend
  • Fixed extension and CLI showing different provider lists than desktopall surfaces now share the same 22 providers with consistent KrnlCode labeling
v2.3.4patchJuly 9, 2026

Desktop app native installer with progress UI, SSH tunnel manager, profile system, and kanban task board.

New features

  • Native Installer UIin-app backend installer with real-time download progress bar, step tracking, speed display, and automatic version checking
  • SSH Tunnel Configurationconfigure and manage SSH tunnels to remote backends with auto-reconnect, key management, and health checks
  • Profile Management Systemnamed profiles with independent provider configs, memory settings, session lists, and per-profile .krnl state isolation
  • Kanban Task Boardvisual task kanban with drag-and-drop columns, task assignment, priority levels, and triage queue support
  • Soul Recordsstructured per-profile agent personality configuration (behavior model, response style, verbosity level, and custom instructions)

Improvements

  • Memory Provider Architectureabstracted memory storage with pluggable provider system: legacy (direct read/write), JSON file, and custom registry providers
  • MCP Server UI Redesignenhanced management with connection testing, tool listing, environment variable editor, and status indicators
  • Windows BuildNSIS one-click installer and portable .exe both published to GitHub Releases
  • Background Graph Buildinitial code graph construction on large projects no longer blocks the first agent task

Bug fixes

  • Fixed MCP server tools not refreshing after config changes without full restart
  • Fixed session continuation not preserving context folder path across app restarts
  • Fixed memory provider switching leaving stale cache entries in active session
  • Fixed SSH tunnel cleanup not running on app quit leaving orphaned processes
v2.3.3patchJuly 8, 2026

Backend stability, Memory V2 provider interface standardization, skills system, and extension performance improvements.

New features

  • Memory Provider Interfacestandardized backend API for memory storage with SQLite, JSON file, and custom provider backends selectable at runtime
  • Skills Systempackaged capabilities in .krnl/skills/<name>/SKILL.md with on-demand loading via use_skill, listing, and discovery
  • Schedules Modulerecurring agent task execution with cron-like scheduling, persistence across restarts, and execution history
  • Gateway Dashboard Integrationreal-time session monitoring, message streaming via Gateway protocol, and remote backend status

Improvements

  • Extension Performancedeferred dependency loading reduces cold-start time by 40% and idle memory footprint
  • Backend CLI Polishcolored output, structured error messages with line numbers, and suggested fixes
  • Provider Auto-Detectionall 14+ supported providers auto-detected from environment variables at startup
  • Python 3.9 Backward Compatibilityconditional slots wrapper enables __slots__ on 3.10+ while falling back gracefully on 3.9

Bug fixes

  • Fixed extension not detecting provider environment variable changes without manual restart
  • Fixed backend OAuth token refresh failing after extended idle periods (>1 hour)
  • Fixed session history truncation on conversations exceeding 200k context tokens
  • Fixed Gateway WebSocket reconnection not retrying on transient network failures
v2.3.2minorJuly 7, 2026

Gateway dashboard protocol, multi-profile architecture, SSH remote tunnels, real-time session monitoring, and soul configuration.

New features

  • Gateway Dashboardfull-duplex real-time session monitoring with message streaming via Gateway protocol and remote backend status
  • Multi-Profile Architectureindependent agent profiles with per-profile provider configs, session lists, memory stores, and .krnl state directories
  • SSH Remote Tunnelsconnect to a remote Krnl backend over SSH with automatic port forwarding, key-based auth, and reconnection
  • Remote Session Syncbrowse, load, and resume sessions from remote backends with full message history and metadata synchronization
  • Soulper-profile agent personality traits, response style adjustments, and behavior presets stored as structured JSON records

Improvements

  • Session Continuation Recordsessions seamlessly continue across app restarts preserving context folder, model override, and attachment stage
  • Chat Transport Fallbackautomatic fallback between Dashboard Gateway and legacy WebSocket transports with health-based switching
  • Model Override Persistenceper-session model selections persist across messages and survive app restart
  • Landing Page Refinementsrecent workspaces list with relative timestamps, session card previews, and activity sparkline bars

Bug fixes

  • Fixed remote session list not populating when backend gateway was unreachable
  • Fixed session continuation items not being recorded for assistant-only turns without tool calls
  • Fixed profile switching leaving stale session caches from previous profile
  • Fixed SSH tunnel hanging on remote disconnect without proper local cleanup
v2.3.1patchJuly 6, 2026

Session context folder persistence, model overrides, MCP catalog UI, and workspace pre-warming improvements in the desktop app.

New features

  • Session Context Folder Persistenceeach session remembers its associated workspace folder; resume automatically loads the correct context path
  • Session Model Overridepick a different model mid-session via the model picker; override persists per-session across restarts
  • Session Continuation Recordingdetailed continuation records (tool calls, results, user messages) for debugging and audit of multi-session tasks
  • Recent Workspace Trackingdesktop app remembers recently opened workspaces in order with relative timestamps for quick access

Improvements

  • MCP Server Catalog UIbrowse pre-defined MCP servers from the catalog with search filtering and one-click installation
  • Workspace Pre-Warmingcode graph and embedding models preload in the background when workspace context changes, reducing first-task latency by ~60%
  • Theme Sync Polishextension toolbar colors, thinking card styling, and command highlight colors match desktop KRNL Void theme
  • Send Button Spinnervisual feedback during pre-warming with rotating indicator and 'Krnl is onboarding...' tooltip

Bug fixes

  • Fixed session context folder being lost when switching workspaces mid-conversation
  • Fixed MCP catalog entries not displaying description and tool metadata
  • Fixed model override not applying to the first user message in a resumed session
  • Fixed workspace pre-warming failing silently when backend process was occupied
  • Fixed extension toolbar not reflecting active Razor mode state after theme change
v2.3.0minorJuly 5, 2026

Complete visual redesign with KRNL Void theme — landing page, sidebar workspace shell, session cards, and cohesive color system across desktop and extension.

New features

  • KRNL Void Themenew default dark theme with void #121316, panel #17181C, teal accent #7DD3C0, and warm gold #D9B26F, applied consistently across all surfaces
  • Landing Page Redesignsidebar + workspace shell layout with directory tree, activity sparkline bars, and expandable session cards grid
  • Session Cards Gridauto-fill grid of session cards with title, preview, message count, and relative timestamps, hoverable with accent border
  • Landing Page Defaultlanding page now shows on every startup regardless of saved workspace; user explicitly selects a directory to enter chat
  • Workspace Auto-Loadingselected workspace from landing page automatically populates the context folder chip in the chat view
  • Extension Theme Syncextension CSS variables updated to match desktop theme (krnl-primary, thinking, command, and tool colors)

Improvements

  • Theme Cohesionlanding page CSS migrated from custom tokens to main theme variables, ensuring consistent look across all themes
  • Nord Aurora Palettestatus colors updated to Nord-inspired values: success green #A3BE8C, error red #BF616A, warning yellow #EBCB8B
  • Font Stacklanding page uses IBM Plex Sans for headings and IBM Plex Mono for paths/timestamps
  • Responsive Layoutlanding page collapses to single-column on screens under 720px

Migration notes

  • Default theme changed to KRNL Voidexisting dark theme users will see the new colors automatically
  • Landing page now shown on every startupselect a directory to reach the chat view
v2.2.9patchJuly 5, 2026

Pre-warming, approval flow fixes, landing page foundation, and release pipeline hardening.

New features

  • Backend Pre-Warmingdesktop and extension now send a prewarm message on context folder change, loading the code graph and embedding model before the first task
  • Landing Page Foundationinitial landing page with recent directories list, session expand/collapse, and Open Folder button
  • Approval Flow Fixadded respondApproval IPC channel through preload → main → krnlClient.approve(), replacing the non-functional stub
  • Approval Scopeweb_search and web_fetch tools added to read-only auto-approve list, eliminating unnecessary approval prompts

Improvements

  • Send Button Spinnerchat send button shows a spinning indicator with 'Krnl is onboarding…' tooltip during pre-warming
  • Loading GIFreduced from 150×150 to 32×32 with transparent background for cleaner UI
  • Release Workflowremoved github-release job that uploaded binaries to main repo (causing storage limits); releases now go only to the dedicated releases repository
  • Repo Migrationall backend repository references migrated from Saurabh7Goku to saurabhgk7tech
  • Extension Pre-WarmprewarmWorkspace() method called after ensureConnected() in runTask() for faster cold starts

Bug fixes

  • Fixed respondClarify being a stub that did nothingreplaced with proper IPC bridge to backend approve()
  • Fixed old approval bar never resolvingdisabled in MessageRow in favor of ClarifyCard (approval_request events)
  • Fixed build error in LandingPagereplaced require() with ES import for loading.gif
Page 1 of 6

Future roadmap

  • Multi-language code graphextend AST analysis beyond Python to TypeScript, Go, and Rust
  • Advanced analyticsper-task cost forecasting, model recommendations, and usage trends
  • Team collaborationshared workspaces, session handoff, and team-level agent memory
  • Mobile supportiOS and Android companion apps for reviewing and approving agent tasks
  • Enhanced MCPexpanded Model Context Protocol with server discovery and sandboxed execution
  • Custom model trainingfine-tuning capabilities for domain-specific coding tasks