Features
VeloxCLI is a Groq-first terminal assistant: full TUI, print and JSONL-friendly automation, transparent memory via /smart-dream and Kairos, and security defaults shaped by a recent audit. Expect sub-two-second turns in typical use; verify against your model and network.
velox fix
Instant project scanning and safe auto-fixes directly from your terminal.
Instant scan
Scans the repository in under a second on typical trees, then groups findings so you see security, hygiene, and style issues without digging through nested logs.
Safe fixes
Only edits that are mechanically safe run automatically—unused imports, stray debugger statements, obvious log noise. Anything ambiguous stays in the report for you to judge; nothing speculative gets rewritten in silence.
Clean output
Structured terminal output is tuned for quick scanning and screenshots: file paths, severities, what changed, and a compact diff preview when fixes apply.
TUI mode
Interactive terminal UI with multi-line input, scrollable transcript, markdown rendering, syntax-highlighted code blocks, and documented keyboard shortcuts. The layout keeps the active prompt, context summary, and tool output in one surface.
Print mode
Non-interactive mode for scripts and CI: send a prompt on stdin, read the model reply on stdout. Exits with a conventional status code so pipelines can branch on failure without spawning the TUI.
Tool execution
Run shell commands from the conversation after explicit confirmation. Each invocation and its stdout or stderr are retained in the session log for audit and follow-up questions.
Kairos
Assistant-mode memory: Kairos retains structured context across turns so long sessions stay coherent. It complements transcript history and file attachments; it does not replace your obligation to review what the model sees.
Smart Dream
/smart-dream performs transparent memory consolidation: context is folded with rules you can inspect instead of an opaque summary. Pair it with Kairos for assistant-mode work where you care what changed between turns.
Focus and resume
/focus trims noise so sustained coding stays fast on Groq. /resume reconnects after detach, tmux, or SSH blips without treating your shell as disposable.
MCP support
Connect external systems through Model Context Protocol servers: databases, internal HTTP APIs, documentation indexes, and other MCP-compatible backends. Configuration lists servers and scopes in the same file as the rest of the client.
Plugin system
Load plugins from a local directory to register custom commands, adjust behavior, and integrate internal tooling. Plugins are discovered at startup according to paths set in configuration.
Configuration
One YAML or TOML file controls default model, system prompts, keybindings, tool permissions, MCP server entries, and plugin search paths. Environment variables override file values for CI and ephemeral environments.
Context management
Add files and directories to the active conversation. Ignored paths follow .gitignore rules. Large trees are split into chunks so prompts respect model context limits without manual editing.
Session history
Save sessions locally and reopen them later. Export a session transcript as markdown for tickets, documentation, or handoff to another developer.
Workspace lock and permissions
A recent security audit informed workspace-locked file access, unified permission checks, trusted hooks, and keeping raw API keys out of logs. The goal is fewer sharp edges than ad-hoc agent scripts; read SECURITY.md and release notes for scope and limitations.
Slash commands
Slash commands cover help, lifecycle, history, status, dream and Kairos flows, focus and resume, tool runs, watches, attachments, diffs, memory, configuration, model selection, plugins, sessions, and MCP. Exact syntax ships with /help.
Slash command index
Comma-separated list of reserved slash prefixes. See in-app /help for syntax and arguments.
/help, /exit, /clear, /history, /status, /dream, /kairos, /smart-dream, /focus, /resume, /run, /watch, /unwatch, /files, /diff, /memory, /config, /model, /plugins, /plugin, /session, /mcp