Skip to content

Release History

Unreleased

Added

  • 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.json config with optional per-provider API keys
  • Functional test suite running against a local Ollama instance