Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[Unreleased]

A TTY notice when a newer honcho-cli is on PyPI (uv tool upgrade honcho-cli). Skipped in JSON mode; disable with HONCHO_NO_UPDATE_CHECK

--setup for openai-compatible writes EMBEDDING_MODEL_CONFIG__OVERRIDES__BASE_URL into the profile .env alongside LLM_OPENAI_BASE_URL (#1068)
--setup API key prompts echo * per character so a paste is visibly received instead of a blank getpass field

honcho start, honcho stop, and honcho status — run a personal Honcho stack in Docker (API, deriver, Postgres, Redis). Profiles live under ~/.honcho/profiles/. First start pins ghcr.io/plastic-labs/honcho:latest by digest and copies the image config.toml. Optional --setup basic / --setup advanced wizard writes LLM overrides to .env (#1029)
honcho session view — session transcript table (--last N, --page N --size M, --all, --reverse, --ids, peer filter via -p). Content is shown verbatim, timestamps are normalized to UTC, and the command is read-only: unlike the other session commands it never get-or-creates the session (#1006)

honcho message list --last N no longer stops at the first page of 50 — it walks pages to fill the requested window (#1006)

Device-code OAuth login for managed Honcho servers. honcho init now offers browser-based login (RFC 8628 device authorization grant) when the host advertises the device grant in its OAuth authorization-server metadata; tokens are persisted to ~/.honcho/config.json and auto-refreshed (#891)
HONCHO_CONFIG_DIR environment variable for pointing the CLI at an alternate config directory (#891)

An OAuth grant now records the host it was minted against and is ignored — neither used nor refreshed — when base_url points elsewhere, so a staging grant is never sent to production. A live OAuth token takes precedence over a stored apiKey, and a dead grant degrades to the saved key with a warning instead of aborting. Device login no longer deletes the shared apiKey, which sibling tools read from the same config file (#891)

Declare click as an explicit dependency. The CLI imported click directly but relied on it being pulled in transitively, so installs without it on the path could fail at runtime (#787)

Initial release of honcho-cli — a terminal for inspecting and managing a Honcho deployment (#424)
workspace, peer, session, message, conclusion, and config command groups for managing resources against any Honcho server
init onboarding flow that prompts for and persists connection settings, with flag/env-var pre-seeding for non-interactive use
Per-command flags, environment variables, and a config file for pointing the CLI at different servers (local, self-hosted, or hosted)
Rich terminal output and an agent-usage mode for scripting against the CLI
Documentation and an agent skill for the CLI (#589)