honcho-cli 0.1.3__tar.gz → 0.1.4__tar.gz

{honcho_cli-0.1.3 → honcho_cli-0.1.4}/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased]
 
+## [0.1.4] - 2026-08-26
+
+### Added
+
+- 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`
+
+### Fixed
+
+- `--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
+
 ## [0.1.3] - 2026-08-25
 
 ### Added

{honcho_cli-0.1.3 → honcho_cli-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: honcho-cli
-Version: 0.1.3
+Version: 0.1.4
 Summary: A terminal for Honcho — memory that reasons.
 Project-URL: Homepage, https://github.com/plastic-labs/honcho
 Project-URL: Repository, https://github.com/plastic-labs/honcho
@@ -47,19 +47,19 @@ uv tool install honcho-cli
 ## Quick Start
 
 ```bash
-honcho init        # confirm/set apiKey + Honcho URL in ~/.honcho/config.json
-honcho start       # optional: local API + deriver + Postgres + Redis (Docker)
-honcho doctor      # verify your config + connectivity
-honcho             # show banner + command list
+honcho init                 # confirm/set apiKey + Honcho URL in ~/.honcho/config.json
+honcho start --setup basic  # local stack: LLM provider key + Docker
+honcho doctor               # verify config + connectivity
+honcho                      # show banner + command list
 ```
 
-`honcho init` reads `apiKey` and `environmentUrl` from the top-level of `~/.honcho/config.json` (the same file other Honcho tools — plugins, host integrations — share). If both are present, it confirms them with you; if either is missing (or you decline), it prompts for the missing value(s) and writes them back. Host-specific entries under `hosts` are left untouched.
+`honcho init` writes `apiKey` and `environmentUrl` to the top-level of `~/.honcho/config.json` (the same file other Honcho tools — plugins, host integrations — share) so the CLI can call a Honcho server. If both are present, it confirms them with you; if either is missing (or you decline), it prompts and writes them back. Host-specific entries under `hosts` are left untouched. It does **not** set the LLM provider key the local deriver needs — that is `honcho start --setup` (or `LLM_*_API_KEY` in the environment).
 
 Per-command scoping (workspace / peer / session) is handled via `-w` / `-p` / `-s` flags or `HONCHO_*` env vars — not persisted as CLI defaults.
 
 ### Local stack
 
-`honcho start` runs a personal Honcho server on your machine (API, deriver, Postgres, Redis) via Docker. Inference is cloud-side: set `LLM_OPENAI_API_KEY`, `LLM_ANTHROPIC_API_KEY`, or `LLM_GEMINI_API_KEY` (env overrides `config.toml`). Stack files live under `~/.honcho/profiles/local/` and are not committed to a project.
+`honcho start --setup basic` runs a personal Honcho server on your machine (API, deriver, Postgres, Redis) via Docker. The wizard writes the LLM provider key into the profile `.env` — `honcho init` cannot do this; its `apiKey` is for calling a Honcho server, not for deriver/dialectic inference. You can also pass `LLM_OPENAI_API_KEY`, `LLM_ANTHROPIC_API_KEY`, or `LLM_GEMINI_API_KEY` in the environment and skip `--setup`. Stack files live under `~/.honcho/profiles/local/` and are not committed to a project.
 
 On first start, the CLI pulls `ghcr.io/plastic-labs/honcho:latest` and **pins that digest** in `profile.json`, then copies the image's `config.toml.example` to `config.toml` in the same directory. `honcho start` never overwrites `config.toml` after that — including when you re-pin the image. Delete the file yourself if you want a fresh copy from a new image.
 
@@ -74,7 +74,6 @@ HONCHO_BASE_URL=http://127.0.0.1:8000 honcho workspace list
 To make local the default, run `honcho init --base-url http://127.0.0.1:8000`.
 
 ```bash
-LLM_OPENAI_API_KEY=sk-... honcho start
 honcho start --setup basic
 honcho start --setup advanced
 honcho status
@@ -88,7 +87,7 @@ honcho stop --wipe     # also delete volumes
 
 | Command | Description |
 |---------|-------------|
-| `honcho init` | Confirm/set `apiKey` + `environmentUrl` in `~/.honcho/config.json` |
+| `honcho init` | Confirm/set `apiKey` + `environmentUrl` in `~/.honcho/config.json`. |
 | `honcho start` | Start a local Honcho stack (API, deriver, Postgres, Redis). Requires Docker and a cloud LLM key. `--setup basic` / `--setup advanced` runs an interactive config wizard (TTY only). Does not change `environmentUrl`. |
 | `honcho stop` | Stop the local stack. `--wipe` also deletes volumes. |
 | `honcho status` | Show every local stack (or `--profile` for one). |
@@ -211,6 +210,7 @@ Precedence (highest first): **flag → env var → config file → default**.
 | `HONCHO_PEER_ID` | `-p` / `--peer` | Peer scope |
 | `HONCHO_SESSION_ID` | `-s` / `--session` | Session scope |
 | `HONCHO_JSON` | `--json` | Force JSON output (`1` / `true`) |
+| `HONCHO_NO_UPDATE_CHECK` | — | Disable the once-a-day upgrade notice (`1` / `true`) |
 | `HONCHO_PROFILE` | `--profile` (start/stop/status) | Local stack profile (default: `local`) |
 | `LLM_OPENAI_API_KEY` | — | Provider key for `honcho start` (also `LLM_ANTHROPIC_API_KEY`, `LLM_GEMINI_API_KEY`) |
 

{honcho_cli-0.1.3 → honcho_cli-0.1.4}/README.md

@@ -22,19 +22,19 @@ uv tool install honcho-cli
 ## Quick Start
 
 ```bash
-honcho init        # confirm/set apiKey + Honcho URL in ~/.honcho/config.json
-honcho start       # optional: local API + deriver + Postgres + Redis (Docker)
-honcho doctor      # verify your config + connectivity
-honcho             # show banner + command list
+honcho init                 # confirm/set apiKey + Honcho URL in ~/.honcho/config.json
+honcho start --setup basic  # local stack: LLM provider key + Docker
+honcho doctor               # verify config + connectivity
+honcho                      # show banner + command list
 ```
 
-`honcho init` reads `apiKey` and `environmentUrl` from the top-level of `~/.honcho/config.json` (the same file other Honcho tools — plugins, host integrations — share). If both are present, it confirms them with you; if either is missing (or you decline), it prompts for the missing value(s) and writes them back. Host-specific entries under `hosts` are left untouched.
+`honcho init` writes `apiKey` and `environmentUrl` to the top-level of `~/.honcho/config.json` (the same file other Honcho tools — plugins, host integrations — share) so the CLI can call a Honcho server. If both are present, it confirms them with you; if either is missing (or you decline), it prompts and writes them back. Host-specific entries under `hosts` are left untouched. It does **not** set the LLM provider key the local deriver needs — that is `honcho start --setup` (or `LLM_*_API_KEY` in the environment).
 
 Per-command scoping (workspace / peer / session) is handled via `-w` / `-p` / `-s` flags or `HONCHO_*` env vars — not persisted as CLI defaults.
 
 ### Local stack
 
-`honcho start` runs a personal Honcho server on your machine (API, deriver, Postgres, Redis) via Docker. Inference is cloud-side: set `LLM_OPENAI_API_KEY`, `LLM_ANTHROPIC_API_KEY`, or `LLM_GEMINI_API_KEY` (env overrides `config.toml`). Stack files live under `~/.honcho/profiles/local/` and are not committed to a project.
+`honcho start --setup basic` runs a personal Honcho server on your machine (API, deriver, Postgres, Redis) via Docker. The wizard writes the LLM provider key into the profile `.env` — `honcho init` cannot do this; its `apiKey` is for calling a Honcho server, not for deriver/dialectic inference. You can also pass `LLM_OPENAI_API_KEY`, `LLM_ANTHROPIC_API_KEY`, or `LLM_GEMINI_API_KEY` in the environment and skip `--setup`. Stack files live under `~/.honcho/profiles/local/` and are not committed to a project.
 
 On first start, the CLI pulls `ghcr.io/plastic-labs/honcho:latest` and **pins that digest** in `profile.json`, then copies the image's `config.toml.example` to `config.toml` in the same directory. `honcho start` never overwrites `config.toml` after that — including when you re-pin the image. Delete the file yourself if you want a fresh copy from a new image.
 
@@ -49,7 +49,6 @@ HONCHO_BASE_URL=http://127.0.0.1:8000 honcho workspace list
 To make local the default, run `honcho init --base-url http://127.0.0.1:8000`.
 
 ```bash
-LLM_OPENAI_API_KEY=sk-... honcho start
 honcho start --setup basic
 honcho start --setup advanced
 honcho status
@@ -63,7 +62,7 @@ honcho stop --wipe     # also delete volumes
 
 | Command | Description |
 |---------|-------------|
-| `honcho init` | Confirm/set `apiKey` + `environmentUrl` in `~/.honcho/config.json` |
+| `honcho init` | Confirm/set `apiKey` + `environmentUrl` in `~/.honcho/config.json`. |
 | `honcho start` | Start a local Honcho stack (API, deriver, Postgres, Redis). Requires Docker and a cloud LLM key. `--setup basic` / `--setup advanced` runs an interactive config wizard (TTY only). Does not change `environmentUrl`. |
 | `honcho stop` | Stop the local stack. `--wipe` also deletes volumes. |
 | `honcho status` | Show every local stack (or `--profile` for one). |
@@ -186,6 +185,7 @@ Precedence (highest first): **flag → env var → config file → default**.
 | `HONCHO_PEER_ID` | `-p` / `--peer` | Peer scope |
 | `HONCHO_SESSION_ID` | `-s` / `--session` | Session scope |
 | `HONCHO_JSON` | `--json` | Force JSON output (`1` / `true`) |
+| `HONCHO_NO_UPDATE_CHECK` | — | Disable the once-a-day upgrade notice (`1` / `true`) |
 | `HONCHO_PROFILE` | `--profile` (start/stop/status) | Local stack profile (default: `local`) |
 | `LLM_OPENAI_API_KEY` | — | Provider key for `honcho start` (also `LLM_ANTHROPIC_API_KEY`, `LLM_GEMINI_API_KEY`) |
 

{honcho_cli-0.1.3 → honcho_cli-0.1.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "honcho-cli"
-version = "0.1.3"
+version = "0.1.4"
 description = "A terminal for Honcho — memory that reasons."
 readme = "README.md"
 requires-python = ">=3.11"

{honcho_cli-0.1.3 → honcho_cli-0.1.4}/src/honcho_cli/__init__.py

@@ -1,3 +1,3 @@
 """Honcho CLI — a terminal for Honcho."""
 
-__version__ = "0.1.3"
+__version__ = "0.1.4"

{honcho_cli-0.1.3 → honcho_cli-0.1.4}/src/honcho_cli/_help.py

@@ -24,6 +24,7 @@ from typer.core import TyperGroup
 from honcho_cli import __version__
 from honcho_cli.branding import BANNER, BRAND
 from honcho_cli.output import use_json
+from honcho_cli.update_check import maybe_print_update_nag
 
 
 # Theme Typer's rich help renderer. Module-level side effect limited to
@@ -59,16 +60,21 @@ def _welcome_panel(title: str, rows: list[tuple[str, str]]) -> Panel:
 
 
 def print_welcome(console: Console) -> None:
-    """Render the curated 3-panel welcome (banner + getting started / memory / commands)."""
+    """Render the curated welcome (banner + getting started / local stack / commands / memory)."""
     if use_json():
         return
     console.print(f"[bold {BRAND}]{BANNER}[/bold {BRAND}]")
     console.print(f"  [dim]v{__version__}[/dim]\n", highlight=False)
 
     start_rows = [
-        ("honcho init",   "configure API key and server URL"),
-        ("honcho start",  "run a local Honcho stack (Docker)"),
-        ("honcho doctor", "verify connection and workspace health"),
+        ("honcho init",                  "configure API key and server URL"),
+        ("honcho start [--setup basic]", "run a local Honcho stack (Docker)"),
+        ("honcho doctor",                "verify connection and workspace health"),
+    ]
+    stack_rows = [
+        ("honcho start / status / stop",          "lifecycle for the local Docker stack"),
+        ("honcho start --setup basic",            "interactive LLM + feature wizard"),
+        ("HONCHO_BASE_URL=http://127.0.0.1:8000", "prefix any command — CLI stays on api.honcho.dev until you set this"),
     ]
     cmd_rows = [
         ("[dim]pattern[/dim]", r"[dim]honcho <command> \[args] \[-w workspace] \[-p peer] \[-s session][/dim]"),
@@ -85,14 +91,15 @@ def print_welcome(console: Console) -> None:
         ("config",     "inspect current configuration"),
     ]
     memory_rows = [
-        ("honcho peer chat \"...\" -p <peer> -w <workspace>","query the Dialectic about a peer"),
-        ("honcho peer inspect -p <peer> -w <workspace>","dashboard: peer card + recent conclusions + configuration"),
+        ("honcho peer chat \"...\" -p <peer> -w <workspace>", "query the Dialectic about a peer"),
+        ("honcho peer inspect -p <peer> -w <workspace>", "dashboard: peer card + recent conclusions + configuration"),
         ("honcho peer representation -p <peer> -w <workspace>", "global peer representation"),
         ("honcho peer representation -p <peer> -w <workspace> -s <session>", "session-scoped peer representation"),
         ("honcho peer card -p <peer> -w <workspace>", "synthesized identity: traits, preferences, instructions"),
-        ("honcho conclusion list -p <peer> -w <workspace>",  "browse peer conclusions"),
+        ("honcho conclusion list -p <peer> -w <workspace>", "browse peer conclusions"),
+        ("honcho session view / context -s <session>", "transcript, or what an agent would see"),
+        ("honcho workspace queue-status", "is the deriver processing?"),
     ]
-
     option_rows = [
         ("-w / --workspace", "scope to a workspace"),
         ("-p / --peer",      "scope to a peer"),
@@ -102,10 +109,12 @@ def print_welcome(console: Console) -> None:
     ]
 
     console.print(_welcome_panel("getting started", start_rows))
+    console.print(_welcome_panel("local stack", stack_rows))
     console.print(_welcome_panel("commands", cmd_rows))
     console.print(_welcome_panel("memory", memory_rows))
     console.print(_welcome_panel("options", option_rows))
     console.print()
+    maybe_print_update_nag()
 
 
 class HonchoTyperGroup(TyperGroup):

{honcho_cli-0.1.3 → honcho_cli-0.1.4}/src/honcho_cli/local/setup.py

@@ -7,6 +7,7 @@ only — the start command rejects ``--setup`` in JSON / non-TTY mode.
 
 from __future__ import annotations
 
+import sys
 import tomllib
 from dataclasses import dataclass
 from pathlib import Path
@@ -14,11 +15,7 @@ from pathlib import Path
 import typer
 from rich.console import Console
 
-from honcho_cli.local.env import (
-    is_placeholder_key,
-    read_env_file,
-    settings_from_environ,
-)
+from honcho_cli.local.env import is_placeholder_key, read_env_file, settings_from_environ
 from honcho_cli.output import print_error
 
 SETUP_MODES = ("basic", "advanced")
@@ -145,6 +142,10 @@ def answers_to_env(answers: SetupAnswers) -> dict[str, str]:
     env[_PROVIDER_KEY_ENV[answers.provider]] = answers.api_key
     if answers.base_url:
         env["LLM_OPENAI_BASE_URL"] = answers.base_url
+        # Embeddings do not inherit this URL; write it so OpenRouter/vLLM
+        # keys are not sent to api.openai.com.
+        if (answers.embedding_transport or "openai") == "openai":
+            env["EMBEDDING_MODEL_CONFIG__OVERRIDES__BASE_URL"] = answers.base_url
 
     if answers.embedding_api_key and answers.embedding_key_transport:
         embed_key = (
@@ -188,9 +189,13 @@ def answers_to_env(answers: SetupAnswers) -> dict[str, str]:
 
 def answers_drop_keys(answers: SetupAnswers) -> tuple[str, ...]:
     """Keys to remove so a previous wizard run cannot leak into this one."""
-    if answers.provider == "openai-compatible":
-        return ()
-    return ("LLM_OPENAI_BASE_URL",)
+    drop: list[str] = []
+    if answers.provider != "openai-compatible":
+        drop.append("LLM_OPENAI_BASE_URL")
+    embed_openai = (answers.embedding_transport or "openai") == "openai"
+    if answers.provider != "openai-compatible" or not embed_openai:
+        drop.append("EMBEDDING_MODEL_CONFIG__OVERRIDES__BASE_URL")
+    return tuple(drop)
 
 
 def run_setup(
@@ -441,13 +446,7 @@ def _prompt_secret(label: str, current: str | None) -> str:
         if choice != "2":
             return current
     _console.print(f"  [dim]{label}[/dim]")
-    raw = typer.prompt(
-        f"  {label}",
-        default="",
-        show_default=False,
-        hide_input=True,
-        prompt_suffix=": ",
-    ).strip()
+    raw = _prompt_masked(f"  {label}: ").strip()
     if not raw or is_placeholder_key(raw):
         print_error(
             "MISSING_LLM_KEY",
@@ -457,6 +456,69 @@ def _prompt_secret(label: str, current: str | None) -> str:
     return raw
 
 
+def _prompt_masked(prompt: str) -> str:
+    """Read a secret, echoing ``*`` per character so paste is visibly received."""
+    stream = sys.stderr
+    stream.write(prompt)
+    stream.flush()
+    chars: list[str] = []
+
+    def _write(text: str) -> None:
+        stream.write(text)
+        stream.flush()
+
+    def _feed(ch: str) -> bool:
+        """Return True when input is complete."""
+        if not ch or ch in ("\n", "\r", "\x04"):
+            _write("\n")
+            return True
+        if ch in ("\x7f", "\x08"):
+            if chars:
+                chars.pop()
+                _write("\b \b")
+            return False
+        if ch == "\x1b":
+            return False
+        if ch.isprintable():
+            chars.append(ch)
+            _write("*")
+        return False
+
+    if sys.platform == "win32":
+        import msvcrt
+
+        while True:
+            ch = msvcrt.getwch()
+            if ch in ("\x00", "\xe0"):
+                msvcrt.getwch()
+                continue
+            if _feed(ch):
+                return "".join(chars)
+
+    import termios
+    import tty
+
+    fd = sys.stdin.fileno()
+    old = termios.tcgetattr(fd)
+    try:
+        tty.setcbreak(fd)
+        while True:
+            ch = sys.stdin.read(1)
+            if ch == "\x1b":
+                nxt = sys.stdin.read(1)
+                if nxt == "[":
+                    while True:
+                        seq = sys.stdin.read(1)
+                        if not seq or "@" <= seq <= "~":
+                            break
+                continue
+            if _feed(ch):
+                return "".join(chars)
+    finally:
+        termios.tcsetattr(fd, termios.TCSADRAIN, old)
+    return "".join(chars)
+
+
 def _redact(key: str) -> str:
     if len(key) <= 4:
         return "***"

{honcho_cli-0.1.3 → honcho_cli-0.1.4}/src/honcho_cli/main.py

@@ -15,6 +15,7 @@ from honcho_cli import __version__
 from honcho_cli._help import HonchoTyperGroup, print_welcome
 from honcho_cli.branding import BANNER
 from honcho_cli.output import set_json_mode
+from honcho_cli.update_check import maybe_print_update_nag
 
 
 app = typer.Typer(
@@ -60,6 +61,7 @@ def main(
     if ctx.invoked_subcommand is None:
         print_welcome(Console())
         raise typer.Exit()
+    maybe_print_update_nag()
 
 
 # Register top-level commands

honcho_cli-0.1.4/src/honcho_cli/update_check.py

@@ -0,0 +1,67 @@
+"""Once-a-day stderr notice when a newer honcho-cli is on PyPI.
+
+Fail-open: any error is swallowed. Cache is ``update-check.json`` beside
+config, not ``config.json``.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import sys
+import time
+
+import httpx
+
+from honcho_cli import __version__
+from honcho_cli.branding import ICON_RUN
+from honcho_cli.config import _config_dir
+from honcho_cli.output import console, use_json
+
+_INTERVAL_S = 24 * 60 * 60
+_PYPI_URL = "https://pypi.org/pypi/honcho-cli/json"
+
+
+def maybe_print_update_nag() -> None:
+    if use_json() or "--json" in sys.argv:
+        return
+    if os.environ.get("HONCHO_NO_UPDATE_CHECK", "").lower() in ("1", "true"):
+        return
+    try:
+        path = _config_dir() / "update-check.json"
+        now = time.time()
+        try:
+            cache = json.loads(path.read_text(encoding="utf-8"))
+        except (OSError, json.JSONDecodeError, UnicodeDecodeError):
+            cache = {}
+        if isinstance(cache, dict) and now - float(cache.get("t") or 0) < _INTERVAL_S:
+            return
+        path.parent.mkdir(parents=True, exist_ok=True)
+        path.write_text(json.dumps({"t": now}), encoding="utf-8")
+        latest = httpx.get(_PYPI_URL, timeout=1.0).json()["info"]["version"]
+        if not isinstance(latest, str) or not _is_newer(latest, __version__):
+            return
+        console.print(f"  {ICON_RUN}  honcho-cli {latest} is available (you have {__version__})")
+        console.print("     [dim]uv tool upgrade honcho-cli[/dim]")
+    except Exception:
+        return
+
+
+def _is_newer(latest: str, current: str) -> bool:
+    def parts(version: str) -> tuple[int, ...]:
+        out: list[int] = []
+        for segment in version.lstrip("v").split("."):
+            num = ""
+            for ch in segment:
+                if ch.isdigit():
+                    num += ch
+                else:
+                    break
+            if not num:
+                break
+            out.append(int(num))
+        return tuple(out) or (0,)
+
+    a, b = parts(latest), parts(current)
+    n = max(len(a), len(b))
+    return a + (0,) * (n - len(a)) > b + (0,) * (n - len(b))

{honcho_cli-0.1.3 → honcho_cli-0.1.4}/tests/test_setup.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 from honcho_cli.local.setup import (
     DIALECTIC_LEVELS,
     SetupAnswers,
+    answers_drop_keys,
     answers_to_env,
     chat_model_default,
     load_toml_setup_defaults,
@@ -46,6 +47,33 @@ def test_basic_anthropic_keeps_openai_embeddings_default():
     assert "EMBEDDING_MODEL_CONFIG__TRANSPORT" not in env
 
 
+def test_openai_compatible_copies_base_url_to_embeddings():
+    env = answers_to_env(
+        SetupAnswers(
+            mode="basic",
+            provider="openai-compatible",
+            api_key="sk-or-test",
+            chat_model="gpt-test",
+            base_url="https://openrouter.ai/api/v1",
+        )
+    )
+    assert env["LLM_OPENAI_BASE_URL"] == "https://openrouter.ai/api/v1"
+    assert (
+        env["EMBEDDING_MODEL_CONFIG__OVERRIDES__BASE_URL"]
+        == "https://openrouter.ai/api/v1"
+    )
+
+
+def test_leaving_openai_compatible_drops_proxy_urls():
+    dropped = answers_drop_keys(
+        SetupAnswers(
+            mode="basic", provider="openai", api_key="sk", chat_model="gpt-test"
+        )
+    )
+    assert "LLM_OPENAI_BASE_URL" in dropped
+    assert "EMBEDDING_MODEL_CONFIG__OVERRIDES__BASE_URL" in dropped
+
+
 def test_chat_default_comes_from_image_toml(tmp_path):
     path = tmp_path / "config.toml"
     path.write_text(