New defaultAgentId field in knosh.json sets a project-wide fallback agent. When set, --agentId becomes optional for prompt, kdocs, and file-defined commands that do not declare agent: in their frontmatter. The explicit --agentId option still takes precedence when supplied.
init --global now creates an empty agents/ directory at ~/.config/knosh/agents/ in addition to writing the config file
init command to write a default knosh.json config file, with --global flag for writing to ~/.config/knosh/knosh.json
list-agents command to list available agents in the configured agents directory
kdocs command to iterate over supplied source files and update their KDoc comments using an LLM
prompt command to run a one-shot LLM prompt using a named agent
Agent configuration via Markdown files with YAML frontmatter (model, temperature, tool permissions, system prompt)
Twelve built-in tools covering filesystem navigation, file I/O, and web access
Support for multiple LLM providers via Koog: Anthropic, Mistral, OpenAI, and Ollama
Per-agent and per-command temperature overrides via --temperature CLI option
--max-iterations option to cap the number of LLM tool-call cycles per run
Retry policy for transient LLM and network errors, including Ollama-specific retries
Tool-call logging with optional full-content logging via --log-full-tool-calls
--log-full-prompts option to log full prompt content for debugging
Rich terminal output via Mordant (Markdown rendering in TTY; plain text elsewhere)
Global and project-local knosh.jsonconfig with optional per-provider API keys
Hermetic functional test suite using Koog's MockPromptExecutor and okio.fakefilesystem.FakeFileSystem; no live Ollama instance required