lithe-cli 0.2.0__tar.gz → 0.2.2__tar.gz

{lithe_cli-0.2.0 → lithe_cli-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lithe-cli
-Version: 0.2.0
+Version: 0.2.2
 Summary: Command-line interface for the lithe agent kernel: chat, one-shot runs, undo, and run inspection.
 License: MIT License
         
@@ -65,7 +65,14 @@ pip install lithe-cli
 ## Configure
 
 There is no default endpoint — the CLI refuses to run rather than silently
-hitting some third-party URL. Point it at any OpenAI-compatible endpoint:
+hitting some third-party URL. The easiest way in is the wizard: on the
+first `lithe chat` / `lithe run` (or any time, via `lithe config`) an
+interactive terminal prompts for the three essentials and saves them to
+`$LITHE_HOME/config.json` (mode 0600 — it holds the key). An optional
+connectivity probe catches typos before your first turn.
+
+To configure by hand instead, point the CLI at any OpenAI-compatible
+endpoint:
 
 ```bash
 export LITHE_API_KEY=sk-...
@@ -73,13 +80,18 @@ export LITHE_BASE_URL=https://your-endpoint/api/v1
 export LITHE_MODEL=your-model
 ```
 
-Flags (`--api-key`, `--base-url`, `--model`) override the environment.
+Resolution order is flag (`--api-key`, `--base-url`, `--model`) >
+environment > saved config file, per key. The wizard never runs without
+a TTY on both ends, so pipes and CI keep the hard refusal; `--no-setup`
+restores that fail-fast behavior on terminals too. `lithe config --show`
+peeks at the saved values with a masked key.
+
 `LITHE_HOME` (default `~/.lithe`) locates the run store; the agent's
 workspace defaults to the current directory (`--workspace` to change).
 
 `lithe doctor` prints the effective configuration — endpoint (with a
-masked key), store, workspace, sandbox backend, skills, MCP servers — so
-you can see what a run would use before starting one.
+masked key), config file, store, workspace, sandbox backend, skills, MCP
+servers — so you can see what a run would use before starting one.
 
 ## Use
 

{lithe_cli-0.2.0 → lithe_cli-0.2.2}/README.md

@@ -18,7 +18,14 @@ pip install lithe-cli
 ## Configure
 
 There is no default endpoint — the CLI refuses to run rather than silently
-hitting some third-party URL. Point it at any OpenAI-compatible endpoint:
+hitting some third-party URL. The easiest way in is the wizard: on the
+first `lithe chat` / `lithe run` (or any time, via `lithe config`) an
+interactive terminal prompts for the three essentials and saves them to
+`$LITHE_HOME/config.json` (mode 0600 — it holds the key). An optional
+connectivity probe catches typos before your first turn.
+
+To configure by hand instead, point the CLI at any OpenAI-compatible
+endpoint:
 
 ```bash
 export LITHE_API_KEY=sk-...
@@ -26,13 +33,18 @@ export LITHE_BASE_URL=https://your-endpoint/api/v1
 export LITHE_MODEL=your-model
 ```
 
-Flags (`--api-key`, `--base-url`, `--model`) override the environment.
+Resolution order is flag (`--api-key`, `--base-url`, `--model`) >
+environment > saved config file, per key. The wizard never runs without
+a TTY on both ends, so pipes and CI keep the hard refusal; `--no-setup`
+restores that fail-fast behavior on terminals too. `lithe config --show`
+peeks at the saved values with a masked key.
+
 `LITHE_HOME` (default `~/.lithe`) locates the run store; the agent's
 workspace defaults to the current directory (`--workspace` to change).
 
 `lithe doctor` prints the effective configuration — endpoint (with a
-masked key), store, workspace, sandbox backend, skills, MCP servers — so
-you can see what a run would use before starting one.
+masked key), config file, store, workspace, sandbox backend, skills, MCP
+servers — so you can see what a run would use before starting one.
 
 ## Use
 

{lithe_cli-0.2.0 → lithe_cli-0.2.2}/lithe_cli/__init__.py

@@ -1,3 +1,3 @@
 """lithe-cli: the command-line interface for the lithe agent kernel."""
 
-__version__ = "0.2.0"
+__version__ = "0.2.2"

{lithe_cli-0.2.0 → lithe_cli-0.2.2}/lithe_cli/__main__.py

@@ -1,4 +1,5 @@
 """Support ``python -m lithe_cli`` alongside the console script."""
+
 import sys
 
 from .main import main

{lithe_cli-0.2.0 → lithe_cli-0.2.2}/lithe_cli/agent.py

@@ -14,6 +14,7 @@ Everything here maps lithe's host contract onto CLI defaults:
 - undo — the bundled tools register reverters, so ``lithe undo`` works with
   zero configuration.
 """
+
 from __future__ import annotations
 
 import json
@@ -25,7 +26,11 @@ from typing import Any
 
 from lithe import AgentContext, LLMConfig, ToolRegistry
 from lithe.bundles import (
-    AgentHost, JsonlRunStore, JsonTodoStore, Workspace, undo_run,
+    AgentHost,
+    JsonlRunStore,
+    JsonTodoStore,
+    Workspace,
+    undo_run,
 )
 from lithe.bundles.download import register_download_tools
 from lithe.bundles.patch import register_apply_patch_tool
@@ -91,8 +96,7 @@ def build_registry(cfg: Config) -> ToolRegistry:
         from lithe.bundles.sandbox import CodeRunner, register_code_tools
 
         runner = CodeRunner(sys.executable, backend=sandbox_backend())
-        register_code_tools(
-            reg, lambda ctx: str(cfg.workspace_dir.resolve()), runner)
+        register_code_tools(reg, lambda ctx: str(cfg.workspace_dir.resolve()), runner)
     if cfg.skills_dir is not None:
         from lithe.bundles.skills import SkillLibrary, register_skill_tool
 
@@ -109,13 +113,18 @@ def build_host(cfg: Config, reg: ToolRegistry) -> AgentHost:
     store = JsonlRunStore(cfg.store_dir)
     prompt = build_system_prompt(cfg)
     return AgentHost(
-        reg, build_llm(cfg), store, max_steps=cfg.max_steps,
+        reg,
+        build_llm(cfg),
+        store,
+        max_steps=cfg.max_steps,
         build_system_prompt=lambda ctx, mode, anchor: prompt,
     )
 
 
 def render_event(
-    ev: dict, verbose: bool = False, stream: bool = False,
+    ev: dict,
+    verbose: bool = False,
+    stream: bool = False,
     pending: dict | None = None,
 ) -> None:
     """Render one runtime event onto the terminal.
@@ -150,8 +159,14 @@ def render_event(
     elif t == "cancelled":
         ui.warn("已取消")
     elif verbose and t == "usage":
-        print(ui.usage(ev.get("prompt_tokens"), ev.get("completion_tokens"),
-                       ev.get("context_tokens"), ev.get("context_percent")))
+        print(
+            ui.usage(
+                ev.get("prompt_tokens"),
+                ev.get("completion_tokens"),
+                ev.get("context_tokens"),
+                ev.get("context_percent"),
+            )
+        )
     elif verbose and t == "reasoning":
         digest = (ev.get("summary") or "").replace("\n", " ")
         if digest:
@@ -159,7 +174,9 @@ def render_event(
 
 
 async def execute(
-    cfg: Config, task: str, history: list[dict] | None = None,
+    cfg: Config,
+    task: str,
+    history: list[dict] | None = None,
     run_id: str | None = None,
 ) -> tuple[str, dict, Any]:
     """Run one task end-to-end; returns (run_id, done_event, host)."""

{lithe_cli-0.2.0 → lithe_cli-0.2.2}/lithe_cli/config.py

@@ -1,9 +1,13 @@
-"""Configuration resolved from CLI flags and the environment.
+"""Configuration resolved from CLI flags, the environment, and a saved file.
 
 Endpoint credentials follow the same convention as lithe's ``live_host``
-example: ``LITHE_API_KEY`` / ``LITHE_BASE_URL`` / ``LITHE_MODEL`` — flags
-override env vars. There is no default endpoint on purpose: the CLI refuses
-to run rather than silently hitting some third-party URL.
+example: ``LITHE_API_KEY`` / ``LITHE_BASE_URL`` / ``LITHE_MODEL``. There
+is no default endpoint on purpose: the CLI refuses to run rather than
+silently hitting some third-party URL. Resolution order is flag > env >
+``$LITHE_HOME/config.json`` (written by the first-run wizard or
+``lithe-cli config``; mode 0600 since it holds the key). On an
+interactive terminal a missing endpoint triggers the wizard instead of
+the refusal — see :mod:`lithe_cli.setup`.
 
 Capability flags (all off unless asked for):
 
@@ -17,6 +21,7 @@ Capability flags (all off unless asked for):
 - ``--vision``     ``image_info`` + ``analyze_image`` (one vision call on
                    the main endpoint, memoized per file hash).
 """
+
 from __future__ import annotations
 
 import json
@@ -101,20 +106,74 @@ def load_mcp_spec(raw: str) -> list:
         raise SystemExit(
             f"MCP 配置解析失败：{exc}\n"
             "spec 应为 JSON 数组（stdio: command/env，http: url/headers），"
-            "例如：--mcp '[{\"name\":\"fs\",\"command\":[\"npx\",\"-y\","
-            "\"@modelcontextprotocol/server-filesystem\",\".\"]}]'"
+            '例如：--mcp \'[{"name":"fs","command":["npx","-y",'
+            '"@modelcontextprotocol/server-filesystem","."]}]\''
         ) from exc
 
 
+_ENDPOINT_KEYS = ("api_key", "base_url", "model")
+
+
+def config_file() -> Path:
+    """Where the wizard-saved endpoint lives."""
+    return lithe_home() / "config.json"
+
+
+def load_saved_endpoint() -> dict:
+    """Read {api_key, base_url, model} from the config file; {} if none.
+
+    A corrupt file is treated as absent — a bad edit should cost the user
+    one re-prompt, not a broken CLI.
+    """
+    try:
+        data = json.loads(config_file().read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError):
+        return {}
+    if not isinstance(data, dict):
+        return {}
+    return {
+        k: data[k].strip()
+        for k in _ENDPOINT_KEYS
+        if isinstance(data.get(k), str) and data[k].strip()
+    }
+
+
+def save_endpoint(api_key: str, base_url: str, model: str) -> Path:
+    """Write the config file; 0600 because it holds the API key."""
+    path = config_file()
+    fresh_dir = not path.parent.exists()
+    path.parent.mkdir(parents=True, exist_ok=True)
+    if fresh_dir:
+        try:
+            path.parent.chmod(0o700)
+        except OSError:
+            pass
+    payload = {
+        k: v
+        for k, v in (("api_key", api_key), ("base_url", base_url), ("model", model))
+    }
+    path.write_text(
+        json.dumps(payload, ensure_ascii=False, indent=2) + "\n", encoding="utf-8"
+    )
+    try:
+        path.chmod(0o600)
+    except OSError:
+        pass
+    return path
+
+
 def load_config(args: Any) -> Config:
     """Merge parsed argparse flags over environment defaults."""
+
     def g(name: str, default):
         return getattr(args, name, default)
 
-    store_dir = (Path(g("store", None)).expanduser()
-                 if g("store", None) else default_store_dir())
-    workspace_dir = (Path(g("workspace", None)).expanduser()
-                     if g("workspace", None) else Path.cwd())
+    store_dir = (
+        Path(g("store", None)).expanduser() if g("store", None) else default_store_dir()
+    )
+    workspace_dir = (
+        Path(g("workspace", None)).expanduser() if g("workspace", None) else Path.cwd()
+    )
     skills = g("skills", None)
     if skills is not None and skills.strip():
         skills_dir: Path | None = Path(skills).expanduser()
@@ -125,10 +184,15 @@ def load_config(args: Any) -> Config:
         skills_dir = cand if cand.is_dir() else None
 
     mcp_raw = g("mcp", None) or os.environ.get(ENV_MCP)
+    saved = load_saved_endpoint()  # flag > env > config file, per key
     return Config(
-        api_key=g("api_key", None) or os.environ.get(ENV_API_KEY),
-        base_url=g("base_url", None) or os.environ.get(ENV_BASE_URL),
-        model=g("model", None) or os.environ.get(ENV_MODEL),
+        api_key=(
+            g("api_key", None) or os.environ.get(ENV_API_KEY) or saved.get("api_key")
+        ),
+        base_url=(
+            g("base_url", None) or os.environ.get(ENV_BASE_URL) or saved.get("base_url")
+        ),
+        model=(g("model", None) or os.environ.get(ENV_MODEL) or saved.get("model")),
         store_dir=store_dir,
         workspace_dir=workspace_dir,
         user_id=g("user", None) or DEFAULT_USER,
@@ -144,19 +208,35 @@ def load_config(args: Any) -> Config:
         mcp_spec=mcp_raw,
         mcp_servers=load_mcp_spec(mcp_raw) if mcp_raw else [],
         vision=g("vision", False),
-        color=(True if g("color", False) else
-               False if g("no_color", False) else None),
+        color=(True if g("color", False) else False if g("no_color", False) else None),
     )
 
 
-def require_endpoint(cfg: Config) -> None:
-    """Exit with a how-to message when no endpoint is configured."""
+def require_endpoint(cfg: Config, interactive: bool = False) -> None:
+    """Ensure an endpoint, launching the first-run wizard when it helps.
+
+    ``interactive`` asks for the wizard; it still only runs on a TTY (both
+    ends), so pipes, captures and CI keep the plain SystemExit.
+    """
     if cfg.has_endpoint:
         return
+    if interactive:
+        from .setup import run_setup_wizard, stdin_is_interactive
+
+        if stdin_is_interactive():
+            saved = run_setup_wizard() or {}
+            cfg.api_key = cfg.api_key or saved.get("api_key")
+            cfg.base_url = cfg.base_url or saved.get("base_url")
+            cfg.model = cfg.model or saved.get("model")
+            if cfg.has_endpoint:
+                return
     raise SystemExit(
-        "缺少模型端点配置。请设置环境变量（或使用对应flag）：\n"
-        f"  export {ENV_API_KEY}=sk-...\n"
-        f"  export {ENV_BASE_URL}=https://your-endpoint/api/v1\n"
-        f"  export {ENV_MODEL}=your-model\n"
+        "缺少模型端点配置。两种方式任选：\n"
+        "  1) 交互式（推荐）：运行 lithe-cli config，按提示输入后保存到\n"
+        f"     {config_file()}\n"
+        "  2) 环境变量（或对应flag）：\n"
+        f"     export {ENV_API_KEY}=sk-...\n"
+        f"     export {ENV_BASE_URL}=https://your-endpoint/api/v1\n"
+        f"     export {ENV_MODEL}=your-model\n"
         "本 CLI 不内置任何默认端点。"
     )

{lithe_cli-0.2.0 → lithe_cli-0.2.2}/lithe_cli/main.py

@@ -8,11 +8,16 @@ Subcommands:
   log RUN_ID   show a stored run's messages and actions
   undo RUN_ID  revert a run's file/todo mutations
   doctor       show the effective configuration and capability status
+  config       interactive endpoint setup (first-run wizard; --show to peek)
 
 Endpoint config: LITHE_API_KEY / LITHE_BASE_URL / LITHE_MODEL (flags
-override). Storage lands in ~/.lithe/runs (LITHE_HOME to move it); the
-agent's workspace is the current directory unless --workspace says else.
+override env, env overrides the wizard-saved $LITHE_HOME/config.json).
+On a TTY, run/chat with no endpoint at all launch the setup wizard
+(--no-setup keeps the hard refusal for scripting). Storage lands in
+~/.lithe/runs (LITHE_HOME to move it); the agent's workspace is the
+current directory unless --workspace says else.
 """
+
 from __future__ import annotations
 
 import argparse
@@ -25,7 +30,7 @@ from lithe.bundles import JsonlRunStore
 
 from . import __version__
 from .agent import build_registry, execute, sandbox_backend, undo
-from .config import load_config, require_endpoint
+from .config import config_file, load_config, require_endpoint
 from .ui import BOLD, CYAN, GREEN, RED, YELLOW, configure, truncate, ui
 
 
@@ -34,8 +39,11 @@ def build_parser() -> argparse.ArgumentParser:
         prog="lithe",
         description="Command-line interface for the lithe agent kernel.",
     )
-    p.add_argument("--version", action="version",
-                   version=f"lithe-cli {__version__} (lithe {lithe_version})")
+    p.add_argument(
+        "--version",
+        action="version",
+        version=f"lithe-cli {__version__} (lithe {lithe_version})",
+    )
     sub = p.add_subparsers(dest="command")
 
     def common(sp: argparse.ArgumentParser) -> None:
@@ -45,40 +53,71 @@ def build_parser() -> argparse.ArgumentParser:
         sp.add_argument("--workspace", help="agent workspace dir (default: cwd)")
         sp.add_argument("--store", help="run store dir (default: ~/.lithe/runs)")
         sp.add_argument("--user", help="user id for the store (default: cli)")
-        sp.add_argument("--download", action="store_true",
-                        help="grant the agent download_file (network fetch)")
-        sp.add_argument("--code", action="store_true",
-                        help="grant run_code/run_file (sandboxed Python; "
-                             "bwrap when available, passthrough otherwise)")
-        sp.add_argument("--skills", metavar="DIR",
-                        help='markdown skill dir (default: $LITHE_HOME/skills '
-                             "when it exists; \"\" disables)")
-        sp.add_argument("--mcp", metavar="SPEC",
-                        help="MCP servers as JSON array/object or @file "
-                             "(env LITHE_MCP)")
-        sp.add_argument("--vision", action="store_true",
-                        help="grant image_info/analyze_image (vision on the "
-                             "main endpoint)")
+        sp.add_argument(
+            "--download",
+            action="store_true",
+            help="grant the agent download_file (network fetch)",
+        )
+        sp.add_argument(
+            "--code",
+            action="store_true",
+            help="grant run_code/run_file (sandboxed Python; "
+            "bwrap when available, passthrough otherwise)",
+        )
+        sp.add_argument(
+            "--skills",
+            metavar="DIR",
+            help="markdown skill dir (default: $LITHE_HOME/skills "
+            'when it exists; "" disables)',
+        )
+        sp.add_argument(
+            "--mcp",
+            metavar="SPEC",
+            help="MCP servers as JSON array/object or @file (env LITHE_MCP)",
+        )
+        sp.add_argument(
+            "--vision",
+            action="store_true",
+            help="grant image_info/analyze_image (vision on the main endpoint)",
+        )
         color = sp.add_mutually_exclusive_group()
-        color.add_argument("--color", action="store_true",
-                           help="force colored output")
-        color.add_argument("--no-color", action="store_true",
-                           help="disable colored output")
-        sp.add_argument("--verbose", "-v", action="store_true",
-                        help="show usage/reasoning events")
+        color.add_argument("--color", action="store_true", help="force colored output")
+        color.add_argument(
+            "--no-color", action="store_true", help="disable colored output"
+        )
+        sp.add_argument(
+            "--verbose", "-v", action="store_true", help="show usage/reasoning events"
+        )
 
     def runtime(sp: argparse.ArgumentParser) -> None:
         common(sp)
-        sp.add_argument("--stream", action="store_true",
-                        help="stream tokens as they generate")
-        sp.add_argument("--max-steps", type=int, default=35,
-                        help="tool-loop step budget (default: 35)")
-        sp.add_argument("--context-window", type=int, default=None,
-                        help="model context window, for fullness gauges")
-        sp.add_argument("--timeout", type=float, default=180.0,
-                        help="per-call timeout in seconds")
-        sp.add_argument("--attempts", type=int, default=2,
-                        help="per-call retry attempts")
+        sp.add_argument(
+            "--stream", action="store_true", help="stream tokens as they generate"
+        )
+        sp.add_argument(
+            "--no-setup",
+            action="store_true",
+            help="skip the first-run endpoint wizard (fail hard "
+            "when unconfigured instead of prompting)",
+        )
+        sp.add_argument(
+            "--max-steps",
+            type=int,
+            default=35,
+            help="tool-loop step budget (default: 35)",
+        )
+        sp.add_argument(
+            "--context-window",
+            type=int,
+            default=None,
+            help="model context window, for fullness gauges",
+        )
+        sp.add_argument(
+            "--timeout", type=float, default=180.0, help="per-call timeout in seconds"
+        )
+        sp.add_argument(
+            "--attempts", type=int, default=2, help="per-call retry attempts"
+        )
 
     run_p = sub.add_parser("run", help="run one task")
     runtime(run_p)
@@ -104,6 +143,15 @@ def build_parser() -> argparse.ArgumentParser:
 
     sub.add_parser("doctor", help="show configuration and capability status")
 
+    config_p = sub.add_parser(
+        "config", help="interactive endpoint setup (first-run wizard)"
+    )
+    config_p.add_argument(
+        "--show",
+        action="store_true",
+        help="print the saved config (key masked) and exit",
+    )
+
     return p
 
 
@@ -128,11 +176,14 @@ def _cmd_runs(cfg: Any, limit: int) -> int:
     rows = []
     for r in reversed(runs):  # newest last, like a log
         task = (r.task or "").replace("\n", " ")
-        rows.append([r.run_id, r.status, str(r.steps),
-                     f"{r.cost:.4f}", task[:60]])
-    print(ui.table(
-        ["run", "status", "steps", "cost", "task"], rows,
-        cell_styles=[ui.s, ui.status, ui.s, ui.s, ui.s]))
+        rows.append([r.run_id, r.status, str(r.steps), f"{r.cost:.4f}", task[:60]])
+    print(
+        ui.table(
+            ["run", "status", "steps", "cost", "task"],
+            rows,
+            cell_styles=[ui.s, ui.status, ui.s, ui.s, ui.s],
+        )
+    )
     return 0
 
 
@@ -142,8 +193,10 @@ def _cmd_log(cfg: Any, run_id: str) -> int:
     if run is None:
         print(ui.s(f"找不到 run {run_id}（user={cfg.user_id}）", RED))
         return 1
-    print(f"run {ui.s(run.run_id, CYAN)}  status={ui.status(run.status)}  "
-          f"steps={run.steps}  model={run.model}")
+    print(
+        f"run {ui.s(run.run_id, CYAN)}  status={ui.status(run.status)}  "
+        f"steps={run.steps}  model={run.model}"
+    )
     print(f"task: {run.task}")
     if run.final:
         print(f"final: {run.final[:500]}")
@@ -164,7 +217,7 @@ def _cmd_log(cfg: Any, run_id: str) -> int:
 
 
 def _cmd_doctor() -> int:
-    from .config import default_skills_dir
+    from .config import default_skills_dir, load_saved_endpoint
 
     class _Args:  # doctor reuses load_config over env-only defaults
         api_key = base_url = model = store = workspace = user = None
@@ -181,14 +234,22 @@ def _cmd_doctor() -> int:
         return shown
 
     if cfg.has_endpoint:
-        endpoint = (f"{cfg.model} @ {cfg.base_url}（key: {mask(cfg.api_key)}）")
+        endpoint = f"{cfg.model} @ {cfg.base_url}（key: {mask(cfg.api_key)}）"
     else:
-        endpoint = ui.s("未配置（run/chat 前需设置 LITHE_API_KEY 等）", RED)
+        endpoint = ui.s(
+            "未配置（run/chat 会进入交互设置，或先运行 lithe-cli config）", RED
+        )
     print(ui.kv("endpoint", endpoint))
 
+    saved = load_saved_endpoint()
+    if saved:
+        state = f"已保存 {saved['model']} @ {saved['base_url']}"
+    else:
+        state = ui.s("未保存（lithe-cli config 可交互配置）", YELLOW)
+    print(ui.kv("config", f"{config_file()}（{state}）"))
+
     try:
-        n_runs = len(JsonlRunStore(cfg.store_dir)
-                     .list_runs(cfg.user_id, limit=10_000))
+        n_runs = len(JsonlRunStore(cfg.store_dir).list_runs(cfg.user_id, limit=10_000))
         store_line = f"{cfg.store_dir}（{n_runs} 个 run）"
     except OSError as exc:
         store_line = ui.s(f"{cfg.store_dir}（读取失败：{exc}）", RED)
@@ -220,11 +281,44 @@ def _cmd_doctor() -> int:
 
 
 def _cmd_run(cfg: Any, task: str) -> int:
-    require_endpoint(cfg)
     _, done, _ = asyncio.run(execute(cfg, task))
     return 0 if done.get("status") == "done" else 1
 
 
+def _cmd_config(show: bool) -> int:
+    """`lithe-cli config [--show]`: run or inspect the endpoint wizard."""
+    from .config import load_saved_endpoint
+    from .setup import run_setup_wizard, stdin_is_interactive
+
+    saved = load_saved_endpoint()
+    if show:
+        if saved:
+            key = saved["api_key"]
+            masked = key if len(key) <= 8 else f"{key[:5]}…{key[-4:]}"
+            print(ui.kv("config", str(config_file())))
+            print(ui.kv("base_url", saved["base_url"]))
+            print(ui.kv("api_key", masked))
+            print(ui.kv("model", saved["model"]))
+        else:
+            print(
+                ui.s(
+                    f"（{config_file()} 尚未创建；不带 --show 运行本命令进入交互配置）",
+                    YELLOW,
+                )
+            )
+        return 0
+    if not stdin_is_interactive():
+        print(
+            ui.s(
+                "交互配置需要终端（当前 stdin 不是 TTY）。\n"
+                "请改用环境变量：LITHE_API_KEY / LITHE_BASE_URL / LITHE_MODEL。",
+                RED,
+            )
+        )
+        return 1
+    return 0 if run_setup_wizard() is not None else 1
+
+
 _CHAT_HELP = """可用命令：
   /help   显示这段帮助
   /tools  列出当前注册的工具
@@ -235,9 +329,7 @@ _CHAT_HELP = """可用命令：
 def _chat_loop(cfg: Any) -> int:
     store = JsonlRunStore(cfg.store_dir)
     run_ids: list[str] = []
-    print(ui.banner(__version__,
-                    cfg.model or "(scripted)",
-                    str(cfg.workspace_dir)))
+    print(ui.banner(__version__, cfg.model or "(scripted)", str(cfg.workspace_dir)))
     while True:
         try:
             line = input(ui.prompt()).strip()
@@ -261,8 +353,7 @@ def _chat_loop(cfg: Any) -> int:
         if line.startswith("/"):
             print(ui.s(f"未知命令 {line}（/help 查看可用命令）", RED))
             continue
-        history = (store.messages_for_runs(run_ids, cfg.user_id)
-                   if run_ids else None)
+        history = store.messages_for_runs(run_ids, cfg.user_id) if run_ids else None
         try:
             # One asyncio.run per turn: each run is self-contained, and the
             # blocking input() stays out of async context.
@@ -284,9 +375,10 @@ def main(argv: list[str] | None = None) -> int:
     cfg = load_config(args)
     configure(cfg.color)
     if args.command == "run":
+        require_endpoint(cfg, interactive=not args.no_setup)
         return _cmd_run(cfg, args.task)
     if args.command == "chat":
-        require_endpoint(cfg)
+        require_endpoint(cfg, interactive=not args.no_setup)
         return _chat_loop(cfg)
     if args.command == "tools":
         return _cmd_tools(cfg)
@@ -298,6 +390,8 @@ def main(argv: list[str] | None = None) -> int:
         return asyncio.run(undo(cfg, args.run_id))
     if args.command == "doctor":
         return _cmd_doctor()
+    if args.command == "config":
+        return _cmd_config(args.show)
     return 2