From 36b2372cebe9f1802dc20dbac53ba186c736ae16 Mon Sep 17 00:00:00 2001
From: ajspig <dragon@monstercode.com>
Date: Tue, 25 Aug 2026 14:57:14 -0400
Subject: [PATCH] feat(cli): surface local stack on the welcome screen

---
 honcho-cli/src/honcho_cli/_help.py | 23 +++++++++++++++--------
 1 file changed, 15 insertions(+), 8 deletions(-)

diff --git a/honcho-cli/src/honcho_cli/_help.py b/honcho-cli/src/honcho_cli/_help.py
index 5e8b48be..936e26b7 100644
--- a/honcho-cli/src/honcho_cli/_help.py
+++ b/honcho-cli/src/honcho_cli/_help.py
@@ -59,16 +59,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 +90,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,6 +108,7 @@ 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))