Changelog¶

All notable changes to kube-q are documented here.

[1.4.0] — 2026-04-14¶

Browser terminal — full kube-q REPL accessible in any browser via xterm.js + WebSocket → node-pty → kq; no client-side logic duplicated, all commands and streaming stay in the Python process
web/server.mjs — production single-port server: Next.js HTTP + PTY WebSocket (/pty-ws) on one port; spawns a kq process per connection
web/pty-server.mjs — dev standalone PTY WebSocket server on port 3001; run alongside next dev via npm run dev
Dockerfile — multi-stage build: Node builder compiles Next.js, runtime stage installs kube-q from PyPI + copies built app; env vars injected at runtime (KUBE_Q_URL, KUBE_Q_API_KEY)
iframe / basePath support — NEXT_PUBLIC_BASE_PATH env var relocates the Next.js app to a sub-path; Content-Security-Policy: frame-ancestors * and X-Frame-Options: ALLOWALL headers allow embedding in any parent page
Download conversation button — toolbar "⬇ Download" button exports the xterm scrollback buffer as a .md file directly to the browser
Custom branding — KUBE_Q_LOGO sets a custom ASCII banner logo; KUBE_Q_TAGLINE sets a custom copyright / tagline line; both configurable via .env or environment variable

kq --search <query> / /search <query> — FTS5 full-text search across all session history with highlighted match snippets; supports FTS5 boolean syntax (pods AND NOT staging); old databases backfilled during migration
/branch — fork the current conversation at the current message count into a new independent session; original is preserved; /branches lists all forks; /title <text> renames a session
SQLite schema v3 — messages_fts FTS5 virtual table with insert/delete triggers, parent_session_id and branch_point columns; branches are ordinary sessions so search finds them automatically

Token footer — every response shows (1.2s · 460 tokens) when the server emits a usage block; servers that omit usage behave exactly as before
/tokens / /cost — Rich panel with per-session prompt/completion/total counts, request count, and estimated dollar cost; rates overridable via KUBE_Q_COST_PER_1K_PROMPT / KUBE_Q_COST_PER_1K_COMPLETION
kq --list tokens column — session listing shows total token count per session; SQLite schema auto-migrates from v1

Configurable display names — --user-name / --agent-name CLI flags, KUBE_Q_USER_NAME / KUBE_Q_AGENT_NAME env vars
Friendly HTTP 401 error handling — clear actionable message instead of raw JSON
.env file support — all settings configurable via KUBE_Q_* env vars; ~/.kube-q/.env and ./.env loaded automatically
Removed YAML config file (pyyaml dependency removed)
Renamed config directory to ~/.kube-q/