pico-cli 0.1.0__tar.gz → 0.1.2__tar.gz

{pico_cli-0.1.0 → pico_cli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pico-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: A Python CLI coding agent — autonomous, tool-using, and session-persistent.
 Project-URL: Homepage, https://github.com/Arya-Ojha/PicoCLI_Learn
 Project-URL: Repository, https://github.com/Arya-Ojha/PicoCLI_Learn
@@ -20,7 +20,7 @@ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Utilities
 Requires-Python: >=3.12
 Requires-Dist: pico-cli-sdk
-Requires-Dist: pico-tui
+Requires-Dist: pico-cli-tui
 Description-Content-Type: text/markdown
 
 # pico
@@ -37,8 +37,8 @@ pico_ai ─► pico_core ─► pico_sdk ─► pico_tui
 
 ## Features
 
-- **Headless CLI** — `picoCLI run "do a task"` completes a coding task end-to-end with a single prompt.
-- **Interactive TUI** — `picoCLI-chat` is a full terminal UI (Textual + Rich) for back-and-forth sessions.
+- **Headless CLI** — `picocli-chat run "do a task"` completes a coding task end-to-end with a single prompt.
+- **Interactive TUI** — `picocli` is a full terminal UI (Textual + Rich) for back-and-forth sessions.
 - **Status bar** — the bottom bar always shows `provider | model`, a `thinking` indicator while streaming, and a color-coded context-window bar (`green < 70%`, `yellow < 90%`, `red ≥ 90%`) with the live token estimate.
 - **Nine hardcoded core tools** — `read`, `write`, `edit`, `grep`, `fetch`, `websearch`, `bash`, `todo`, and `task` (see ADR-0003, ADR-0005).
 - **Todo tracking** — the agent tracks multi-step work with a `todo` tool (add / update / list / clear); the TUI shows the in-memory list in a read-only side panel that appears once the first todo exists. A run only ends once every todo is completed — stopping early nudges the agent back in. When the run ends clean, the list is cleared for the next run (a run stopped by the stuck-model guard keeps its open todos).
@@ -80,10 +80,43 @@ Dependencies flow one way — `pico_ai` ← `pico_core` ← `pico_sdk` ← `pico
 | DeepSeek | `DEEPSEEK_API_KEY` | Chat + reasoner (reasoning streams as thinking blocks) |
 | Ollama | — | Local server (`OLLAMA_HOST`, default `http://localhost:11434`) |
 
-In the TUI, `/provider` opens a picker with ✓/✗ setup status, then a setup form for that provider's API key, base URL, model, and extras. Only changed values are stored (in `settings.json` — prefer env vars on shared machines); blanks fall back to env/defaults. Effective precedence: field default < environment < stored value. Switching providers resets the model to that provider's stored/default model. Headless: `picoCLI run --provider ollama "..."`.
+In the TUI, `/provider` opens a picker with ✓/✗ setup status, then a setup form for that provider's API key, base URL, model, and extras. Only changed values are stored (in `settings.json` — prefer env vars on shared machines); blanks fall back to env/defaults. Effective precedence: field default < environment < stored value. Switching providers resets the model to that provider's stored/default model. Headless: `picocli-chat run --provider ollama "..."`.
 
 ## Installation
 
+Requires Python **3.12+**.
+
+```bash
+# recommended: isolated install — `picocli` + `picocli-chat` work in any
+# directory, like `npm i -g`
+pipx install pico-cli
+
+# ... or via uv (same result)
+uv tool install pico-cli
+
+# plain pip also works (see the Windows PATH note below)
+pip install pico-cli
+
+# try without installing (npx-style)
+uvx pico-cli --help
+```
+
+Then open a terminal **in any directory** and run `picocli`. On first launch (no API key yet) the provider setup opens automatically — pick a provider, paste the key, done. Keys can also come from environment variables (see Configuration below).
+
+### Windows: `pip install` and PATH
+
+`pip --user` installs (the default when site-packages isn't writable) drop the commands into `~/.local`-style user Scripts, which is often **not** on PATH — that's when `picocli` is "not recognized". Prefer `pipx`/`uv tool` above, or add the dir once (then open a fresh terminal):
+
+```powershell
+$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
+$newDir = "$env:APPDATA\Python\Python314\Scripts"  # adjust version to yours
+if ($userPath -split ";" -notcontains $newDir) {
+  [Environment]::SetEnvironmentVariable("Path", "$userPath;$newDir", "User")
+}
+```
+
+### From source (contributors)
+
 ```bash
 uv sync
 ```
@@ -128,22 +161,22 @@ Create `~/.pico/settings.json` to override defaults:
 
 ```bash
 # complete a task in one shot
-uv run picoCLI run "explain what this repo does"
+uv run picocli-chat run "explain what this repo does"
 
 # let the agent run shell commands (bash is on by default)
-uv run picoCLI run "run the tests and fix failures"
+uv run picocli-chat run "run the tests and fix failures"
 
 # work in another directory, pick a model
-uv run picoCLI run "summarize this code" --cwd D:\some\repo --model openai/gpt-4o-mini
+uv run picocli-chat run "summarize this code" --cwd D:\some\repo --model openai/gpt-4o-mini
 
 # resume a previous session by id
-uv run picoCLI run "continue" --session <session-id>
+uv run picocli-chat run "continue" --session <session-id>
 
 # compact a session headlessly (with optional steering text)
-uv run picoCLI run "/compact focus on the auth refactor"
+uv run picocli-chat run "/compact focus on the auth refactor"
 ```
 
-Flags for `picoCLI run`:
+Flags for `picocli-chat run`:
 
 | Flag | Purpose |
 |---|---|
@@ -159,10 +192,10 @@ Flags for `picoCLI run`:
 ### Interactive TUI
 
 ```bash
-uv run picoCLI-chat
+uv run picocli
 ```
 
-`picoCLI-chat` shares the same flags. Inside the prompt you can type a message or use:
+`picocli` shares the same flags. Inside the prompt you can type a message or use:
 
 | Slash command | Key | Action |
 |---|---|---|
@@ -202,7 +235,7 @@ Permission gating via `allowed_tools` in `settings.json` (`null` = all tools, `[
 
 ## Where sessions live
 
-Sessions are persisted as JSONL under `~/.pico/sessions/<id>.jsonl` by default (configurable via `session_dir`). Both `picoCLI run` and `picoCLI-chat` accept `--session <id>` to resume; `/history`, `/fork`, and `/undo` rewind within the tree without deleting nodes.
+Sessions are persisted as JSONL under `~/.pico/sessions/<id>.jsonl` by default (configurable via `session_dir`). Both `picocli-chat run` and `picocli` accept `--session <id>` to resume; `/history`, `/fork`, and `/undo` rewind within the tree without deleting nodes.
 
 ## Development
 
@@ -215,10 +248,10 @@ uv run mypy packages/pico_ai/src packages/pico_core/src packages/pico_sdk/src pa
 
 # build all wheels into dist/ (root `pico-cli` is a meta-package: deps + entry points only)
 uv build --package pico-cli --out-dir dist
-uv build --package pico-ai --out-dir dist
-uv build --package pico-core --out-dir dist
+uv build --package pico-cli-ai --out-dir dist
+uv build --package pico-cli-core --out-dir dist
 uv build --package pico-cli-sdk --out-dir dist
-uv build --package pico-tui --out-dir dist
+uv build --package pico-cli-tui --out-dir dist
 ```
 
 The test suite is network-free: it drives the whole agent loop through a scripted fake provider (`FakeProvider`) and a temporary filesystem, exercising `pico_ai`, `pico_core`, `pico_sdk`, and `pico_tui`.

{pico_cli-0.1.0 → pico_cli-0.1.2}/README.md

@@ -12,8 +12,8 @@ pico_ai ─► pico_core ─► pico_sdk ─► pico_tui
 
 ## Features
 
-- **Headless CLI** — `picoCLI run "do a task"` completes a coding task end-to-end with a single prompt.
-- **Interactive TUI** — `picoCLI-chat` is a full terminal UI (Textual + Rich) for back-and-forth sessions.
+- **Headless CLI** — `picocli-chat run "do a task"` completes a coding task end-to-end with a single prompt.
+- **Interactive TUI** — `picocli` is a full terminal UI (Textual + Rich) for back-and-forth sessions.
 - **Status bar** — the bottom bar always shows `provider | model`, a `thinking` indicator while streaming, and a color-coded context-window bar (`green < 70%`, `yellow < 90%`, `red ≥ 90%`) with the live token estimate.
 - **Nine hardcoded core tools** — `read`, `write`, `edit`, `grep`, `fetch`, `websearch`, `bash`, `todo`, and `task` (see ADR-0003, ADR-0005).
 - **Todo tracking** — the agent tracks multi-step work with a `todo` tool (add / update / list / clear); the TUI shows the in-memory list in a read-only side panel that appears once the first todo exists. A run only ends once every todo is completed — stopping early nudges the agent back in. When the run ends clean, the list is cleared for the next run (a run stopped by the stuck-model guard keeps its open todos).
@@ -55,10 +55,43 @@ Dependencies flow one way — `pico_ai` ← `pico_core` ← `pico_sdk` ← `pico
 | DeepSeek | `DEEPSEEK_API_KEY` | Chat + reasoner (reasoning streams as thinking blocks) |
 | Ollama | — | Local server (`OLLAMA_HOST`, default `http://localhost:11434`) |
 
-In the TUI, `/provider` opens a picker with ✓/✗ setup status, then a setup form for that provider's API key, base URL, model, and extras. Only changed values are stored (in `settings.json` — prefer env vars on shared machines); blanks fall back to env/defaults. Effective precedence: field default < environment < stored value. Switching providers resets the model to that provider's stored/default model. Headless: `picoCLI run --provider ollama "..."`.
+In the TUI, `/provider` opens a picker with ✓/✗ setup status, then a setup form for that provider's API key, base URL, model, and extras. Only changed values are stored (in `settings.json` — prefer env vars on shared machines); blanks fall back to env/defaults. Effective precedence: field default < environment < stored value. Switching providers resets the model to that provider's stored/default model. Headless: `picocli-chat run --provider ollama "..."`.
 
 ## Installation
 
+Requires Python **3.12+**.
+
+```bash
+# recommended: isolated install — `picocli` + `picocli-chat` work in any
+# directory, like `npm i -g`
+pipx install pico-cli
+
+# ... or via uv (same result)
+uv tool install pico-cli
+
+# plain pip also works (see the Windows PATH note below)
+pip install pico-cli
+
+# try without installing (npx-style)
+uvx pico-cli --help
+```
+
+Then open a terminal **in any directory** and run `picocli`. On first launch (no API key yet) the provider setup opens automatically — pick a provider, paste the key, done. Keys can also come from environment variables (see Configuration below).
+
+### Windows: `pip install` and PATH
+
+`pip --user` installs (the default when site-packages isn't writable) drop the commands into `~/.local`-style user Scripts, which is often **not** on PATH — that's when `picocli` is "not recognized". Prefer `pipx`/`uv tool` above, or add the dir once (then open a fresh terminal):
+
+```powershell
+$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
+$newDir = "$env:APPDATA\Python\Python314\Scripts"  # adjust version to yours
+if ($userPath -split ";" -notcontains $newDir) {
+  [Environment]::SetEnvironmentVariable("Path", "$userPath;$newDir", "User")
+}
+```
+
+### From source (contributors)
+
 ```bash
 uv sync
 ```
@@ -103,22 +136,22 @@ Create `~/.pico/settings.json` to override defaults:
 
 ```bash
 # complete a task in one shot
-uv run picoCLI run "explain what this repo does"
+uv run picocli-chat run "explain what this repo does"
 
 # let the agent run shell commands (bash is on by default)
-uv run picoCLI run "run the tests and fix failures"
+uv run picocli-chat run "run the tests and fix failures"
 
 # work in another directory, pick a model
-uv run picoCLI run "summarize this code" --cwd D:\some\repo --model openai/gpt-4o-mini
+uv run picocli-chat run "summarize this code" --cwd D:\some\repo --model openai/gpt-4o-mini
 
 # resume a previous session by id
-uv run picoCLI run "continue" --session <session-id>
+uv run picocli-chat run "continue" --session <session-id>
 
 # compact a session headlessly (with optional steering text)
-uv run picoCLI run "/compact focus on the auth refactor"
+uv run picocli-chat run "/compact focus on the auth refactor"
 ```
 
-Flags for `picoCLI run`:
+Flags for `picocli-chat run`:
 
 | Flag | Purpose |
 |---|---|
@@ -134,10 +167,10 @@ Flags for `picoCLI run`:
 ### Interactive TUI
 
 ```bash
-uv run picoCLI-chat
+uv run picocli
 ```
 
-`picoCLI-chat` shares the same flags. Inside the prompt you can type a message or use:
+`picocli` shares the same flags. Inside the prompt you can type a message or use:
 
 | Slash command | Key | Action |
 |---|---|---|
@@ -177,7 +210,7 @@ Permission gating via `allowed_tools` in `settings.json` (`null` = all tools, `[
 
 ## Where sessions live
 
-Sessions are persisted as JSONL under `~/.pico/sessions/<id>.jsonl` by default (configurable via `session_dir`). Both `picoCLI run` and `picoCLI-chat` accept `--session <id>` to resume; `/history`, `/fork`, and `/undo` rewind within the tree without deleting nodes.
+Sessions are persisted as JSONL under `~/.pico/sessions/<id>.jsonl` by default (configurable via `session_dir`). Both `picocli-chat run` and `picocli` accept `--session <id>` to resume; `/history`, `/fork`, and `/undo` rewind within the tree without deleting nodes.
 
 ## Development
 
@@ -190,10 +223,10 @@ uv run mypy packages/pico_ai/src packages/pico_core/src packages/pico_sdk/src pa
 
 # build all wheels into dist/ (root `pico-cli` is a meta-package: deps + entry points only)
 uv build --package pico-cli --out-dir dist
-uv build --package pico-ai --out-dir dist
-uv build --package pico-core --out-dir dist
+uv build --package pico-cli-ai --out-dir dist
+uv build --package pico-cli-core --out-dir dist
 uv build --package pico-cli-sdk --out-dir dist
-uv build --package pico-tui --out-dir dist
+uv build --package pico-cli-tui --out-dir dist
 ```
 
 The test suite is network-free: it drives the whole agent loop through a scripted fake provider (`FakeProvider`) and a temporary filesystem, exercising `pico_ai`, `pico_core`, `pico_sdk`, and `pico_tui`.

{pico_cli-0.1.0 → pico_cli-0.1.2}/packages/pico_ai/README.md

@@ -1,4 +1,4 @@
-# pico-ai
+# pico-cli-ai
 
 LLM abstraction and protocol normalisation for `pico-cli`: one unified streaming "AI call" shape plus per-provider adapters (OpenRouter, OpenAI, Anthropic, Gemini, DeepSeek, local Ollama).
 

{pico_cli-0.1.0 → pico_cli-0.1.2}/packages/pico_ai/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
-name = "pico-ai"
-version = "0.1.0"
+name = "pico-cli-ai"
+version = "0.1.2"
 description = "LLM abstraction and protocol normalisation."
 readme = "README.md"
 license = "MIT"

{pico_cli-0.1.0 → pico_cli-0.1.2}/packages/pico_core/README.md

@@ -1,4 +1,4 @@
-# pico-core
+# pico-cli-core
 
 The agent loop (explicit finite-state machine) and the append-only, tree-based session model for `pico-cli`: nine hardcoded core tools (`read`, `write`, `edit`, `grep`, `fetch`, `websearch`, `bash`, `todo`, `task`), todo tracking, sub-agents, and compaction.
 

{pico_cli-0.1.0 → pico_cli-0.1.2}/packages/pico_core/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
-name = "pico-core"
-version = "0.1.0"
+name = "pico-cli-core"
+version = "0.1.2"
 description = "Agent loop and session tree."
 readme = "README.md"
 license = "MIT"
@@ -15,7 +15,7 @@ classifiers = [
     "Programming Language :: Python :: 3.12",
 ]
 requires-python = ">=3.12"
-dependencies = ["pico-ai", "pydantic>=2", "httpx>=0.27"]
+dependencies = ["pico-cli-ai", "pydantic>=2", "httpx>=0.27"]
 
 [project.urls]
 Homepage = "https://github.com/Arya-Ojha/PicoCLI_Learn"
@@ -30,4 +30,4 @@ build-backend = "hatchling.build"
 packages = ["src/pico_core"]
 
 [tool.uv.sources]
-pico-ai = { workspace = true }
+pico-cli-ai = { workspace = true }

{pico_cli-0.1.0 → pico_cli-0.1.2}/packages/pico_sdk/README.md

@@ -1,5 +1,5 @@
 # pico-cli-sdk
 
-Headless library API for `pico-cli`: `AgentSession`, curated observe-only hooks, `SKILL.md` skills, provider setup, and the `picoCLI` command-line interface.
+Headless library API for `pico-cli`: `AgentSession`, curated observe-only hooks, `SKILL.md` skills, provider setup, and the `picocli-chat` command-line interface.
 
 See the [pico-cli README](https://github.com/Arya-Ojha/PicoCLI_Learn#readme) for the full picture.

{pico_cli-0.1.0 → pico_cli-0.1.2}/packages/pico_sdk/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pico-cli-sdk"
-version = "0.1.0"
+version = "0.1.2"
 description = "Headless library API and extension/plugin binding."
 readme = "README.md"
 license = "MIT"
@@ -16,14 +16,14 @@ classifiers = [
     "Programming Language :: Python :: 3.12",
 ]
 requires-python = ">=3.12"
-dependencies = ["pico-core", "pico-ai", "pydantic>=2"]
+dependencies = ["pico-cli-core", "pico-cli-ai", "pydantic>=2"]
 
 [project.urls]
 Homepage = "https://github.com/Arya-Ojha/PicoCLI_Learn"
 Repository = "https://github.com/Arya-Ojha/PicoCLI_Learn"
 Issues = "https://github.com/Arya-Ojha/PicoCLI_Learn/issues"
 
-# Note: the `picoCLI` entry point lives on the `pico-cli` meta-package only,
+# Note: the `picocli-chat` entry point lives on the `pico-cli` meta-package only,
 # so installing the stack never ships duplicate console scripts.
 [build-system]
 requires = ["hatchling"]
@@ -33,5 +33,5 @@ build-backend = "hatchling.build"
 packages = ["src/pico_sdk"]
 
 [tool.uv.sources]
-pico-core = { workspace = true }
-pico-ai = { workspace = true }
+pico-cli-core = { workspace = true }
+pico-cli-ai = { workspace = true }

{pico_cli-0.1.0 → pico_cli-0.1.2}/packages/pico_sdk/src/pico_sdk/cli.py

@@ -53,7 +53,7 @@ def apply_cli_overrides(args: argparse.Namespace, settings: Settings) -> bool:
 
 
 def build_parser() -> argparse.ArgumentParser:
-    parser = argparse.ArgumentParser(prog="picoCLI", description="A headless coding agent.")
+    parser = argparse.ArgumentParser(prog="picocli-chat", description="A headless coding agent.")
     sub = parser.add_subparsers(dest="command", required=True)
 
     run = sub.add_parser("run", help="Run the agent on a prompt.")
@@ -97,7 +97,7 @@ async def run_command(args: argparse.Namespace) -> int:
         sys.stderr.write(
             f"error: provider '{settings.provider}' is missing required "
             f"config: {', '.join(missing)}.\n"
-            f"Run `picoCLI-chat` and use /provider to configure it, or set "
+             f"Run `picocli` and use /provider to configure it, or set "
             f"the corresponding environment variable.\n"
         )
         return 1

{pico_cli-0.1.0 → pico_cli-0.1.2}/packages/pico_tui/README.md

@@ -1,5 +1,5 @@
-# pico-tui
+# pico-cli-tui
 
-Interactive terminal UI for `pico-cli` (Textual + Rich): chat log, todo side panel, trace view, filterable pickers, provider setup forms, and the `picoCLI-chat` entry point.
+Interactive terminal UI for `pico-cli` (Textual + Rich): chat log, todo side panel, trace view, filterable pickers, provider setup forms, and the `picocli` entry point.
 
 See the [pico-cli README](https://github.com/Arya-Ojha/PicoCLI_Learn#readme) for the full picture.

{pico_cli-0.1.0 → pico_cli-0.1.2}/packages/pico_tui/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
-name = "pico-tui"
-version = "0.1.0"
+name = "pico-cli-tui"
+version = "0.1.2"
 description = "Terminal user interface view."
 readme = "README.md"
 license = "MIT"
@@ -27,7 +27,7 @@ Homepage = "https://github.com/Arya-Ojha/PicoCLI_Learn"
 Repository = "https://github.com/Arya-Ojha/PicoCLI_Learn"
 Issues = "https://github.com/Arya-Ojha/PicoCLI_Learn/issues"
 
-# Note: the `picoCLI-chat` entry point lives on the `pico-cli`
+# Note: the `picocli` entry point lives on the `pico-cli`
 # meta-package only, so installing the stack never ships duplicate
 # console scripts.
 [build-system]

{pico_cli-0.1.0 → pico_cli-0.1.2}/packages/pico_tui/src/pico_tui/app.py

@@ -357,10 +357,20 @@ class PicoApp(App[None]):
         ("f1", "show_help", "Help"),
     ]
 
-    def __init__(self, mgr: _SessionManager, *, startup_notice: str = "") -> None:
+    def __init__(
+        self,
+        mgr: _SessionManager,
+        *,
+        startup_notice: str = "",
+        auto_setup: bool = False,
+    ) -> None:
         super().__init__()
         self._mgr = mgr
         self._startup_notice = startup_notice
+        # First-run onboarding: when True and the active provider is
+        # missing required config, the provider picker opens on launch
+        # so keys/URLs are entered in-UI instead of discovered via /help.
+        self._auto_setup = auto_setup
         self._streaming = False
         # Everything written to the chat log, in order. Thinking blocks are
         # stored as ThinkingSegment so they can collapse/expand on click.
@@ -399,6 +409,10 @@ class PicoApp(App[None]):
             self._write_chat(
                 Panel(self._startup_notice, title="setup", border_style="yellow")
             )
+        if self._auto_setup:
+            settings = self._mgr.session.settings
+            if missing_required(settings.provider, settings):
+                self.call_after_refresh(self._show_provider_picker)
 
     def _refresh_todo_panel(self) -> None:
         """Re-render the todo side panel (auto-hides while empty)."""
@@ -878,7 +892,7 @@ class PicoApp(App[None]):
 
 def main(argv: list[str] | None = None) -> int:
     parser = argparse.ArgumentParser(
-        prog="picoCLI-chat", description="Interactive pico session (Textual TUI)."
+        prog="picocli", description="Interactive pico session (Textual TUI)."
     )
     parser.add_argument(
         "--no-bash",
@@ -955,7 +969,7 @@ def main(argv: list[str] | None = None) -> int:
             f"Provider {provider_label} is missing required config: "
             f"{', '.join(missing)}. Use /provider to configure it."
         )
-    app = PicoApp(mgr, startup_notice=startup_notice)
+    app = PicoApp(mgr, startup_notice=startup_notice, auto_setup=True)
     app.run()
     return 0
 

{pico_cli-0.1.0 → pico_cli-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pico-cli"
-version = "0.1.0"
+version = "0.1.2"
 description = "A Python CLI coding agent — autonomous, tool-using, and session-persistent."
 readme = "README.md"
 license = "MIT"
@@ -18,7 +18,7 @@ classifiers = [
     "Topic :: Utilities",
 ]
 requires-python = ">=3.12"
-dependencies = ["pico-cli-sdk", "pico-tui"]
+dependencies = ["pico-cli-sdk", "pico-cli-tui"]
 
 [project.urls]
 Homepage = "https://github.com/Arya-Ojha/PicoCLI_Learn"
@@ -26,8 +26,8 @@ Repository = "https://github.com/Arya-Ojha/PicoCLI_Learn"
 Issues = "https://github.com/Arya-Ojha/PicoCLI_Learn/issues"
 
 [project.scripts]
-picoCLI = "pico_sdk.cli:main"
-picoCLI-chat = "pico_tui.app:main"
+picocli-chat = "pico_sdk.cli:main"
+picocli = "pico_tui.app:main"
 
 # The root `pico` dist is a meta-package: the implementation lives in the
 # workspace members, so the wheel ships the stub above plus metadata
@@ -44,7 +44,7 @@ members = ["packages/*"]
 
 [tool.uv.sources]
 pico-cli-sdk = { workspace = true }
-pico-tui = { workspace = true }
+pico-cli-tui = { workspace = true }
 
 [dependency-groups]
 dev = [

{pico_cli-0.1.0 → pico_cli-0.1.2}/src/pico/__init__.py

@@ -2,5 +2,5 @@
 
 ``pico_ai``, ``pico_core``, ``pico_sdk``, and ``pico_tui`` (under
 ``packages/``) provide the implementation; this dist only carries the
-dependency pins and the ``picoCLI`` / ``picoCLI-chat`` entry points.
+dependency pins and the ``picocli`` / ``picocli-chat`` entry points.
 """

pico_cli-0.1.2/tests/test_first_run_setup.py

@@ -0,0 +1,70 @@
+"""First-run onboarding: missing provider config auto-opens setup."""
+
+import pytest
+
+from pico_sdk.config import Settings
+from pico_sdk.providers import create_provider, missing_required
+from pico_tui.app import PicoApp, _SessionManager
+from pico_tui.provider_picker import ProviderPickerScreen
+
+from conftest import FakeProvider, make_session
+
+
+@pytest.fixture
+def fresh_settings(monkeypatch):
+    """Settings as on a brand-new machine: no keys anywhere."""
+    for var in (
+        "OPENROUTER_API_KEY",
+        "OPENAI_API_KEY",
+        "ANTHROPIC_API_KEY",
+        "GOOGLE_API_KEY",
+        "DEEPSEEK_API_KEY",
+    ):
+        monkeypatch.delenv(var, raising=False)
+    settings = Settings()
+    assert missing_required(settings.provider, settings), "expected missing config"
+    return settings
+
+
+def _app(tmp_path, settings, auto_setup=False):
+    session = make_session(
+        FakeProvider([]), tmp_path, settings=settings, load_skills=False
+    )
+    return PicoApp(_SessionManager(session), auto_setup=auto_setup)
+
+
+async def test_missing_config_auto_opens_provider_picker(tmp_path, fresh_settings):
+    app = _app(tmp_path, fresh_settings, auto_setup=True)
+    async with app.run_test() as pilot:
+        await pilot.pause()
+        await pilot.pause()
+        assert isinstance(app.screen, ProviderPickerScreen)
+
+
+async def test_auto_setup_off_by_default(tmp_path, fresh_settings):
+    app = _app(tmp_path, fresh_settings)
+    async with app.run_test() as pilot:
+        await pilot.pause()
+        assert not isinstance(app.screen, ProviderPickerScreen)
+
+
+async def test_configured_never_auto_opens(tmp_path, monkeypatch):
+    monkeypatch.setenv("OPENROUTER_API_KEY", "test-key")
+    settings = Settings()
+    assert not missing_required(settings.provider, settings)
+    session = make_session(
+        create_provider(settings), tmp_path, settings=settings, load_skills=False
+    )
+    app = PicoApp(_SessionManager(session), auto_setup=True)
+    async with app.run_test() as pilot:
+        await pilot.pause()
+        await pilot.pause()
+        assert not isinstance(app.screen, ProviderPickerScreen)
+
+
+def test_main_requests_auto_setup():
+    import inspect
+
+    from pico_tui.app import main
+
+    assert "auto_setup=True" in inspect.getsource(main)

{pico_cli-0.1.0 → pico_cli-0.1.2}/uv.lock

@@ -8,11 +8,11 @@ resolution-markers = [
 
 [manifest]
 members = [
-    "pico-ai",
     "pico-cli",
+    "pico-cli-ai",
+    "pico-cli-core",
     "pico-cli-sdk",
-    "pico-core",
-    "pico-tui",
+    "pico-cli-tui",
 ]
 
 [[package]]
@@ -406,28 +406,13 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/f1/d9/7fb5aa316bc299258e68c73ba3bddbc499654a07f151cba08f6153988714/pathspec-1.1.1-py3-none-any.whl", hash = "sha256:a00ce642f577bf7f473932318056212bc4f8bfdf53128c78bbd5af0b9b20b189", size = 57328, upload-time = "2026-04-27T01:46:07.06Z" },
 ]
 
-[[package]]
-name = "pico-ai"
-version = "0.1.0"
-source = { editable = "packages/pico_ai" }
-dependencies = [
-    { name = "httpx" },
-    { name = "pydantic" },
-]
-
-[package.metadata]
-requires-dist = [
-    { name = "httpx", specifier = ">=0.27" },
-    { name = "pydantic", specifier = ">=2" },
-]
-
 [[package]]
 name = "pico-cli"
-version = "0.1.0"
+version = "0.1.2"
 source = { editable = "." }
 dependencies = [
     { name = "pico-cli-sdk" },
-    { name = "pico-tui" },
+    { name = "pico-cli-tui" },
 ]
 
 [package.dev-dependencies]
@@ -440,7 +425,7 @@ dev = [
 [package.metadata]
 requires-dist = [
     { name = "pico-cli-sdk", editable = "packages/pico_sdk" },
-    { name = "pico-tui", editable = "packages/pico_tui" },
+    { name = "pico-cli-tui", editable = "packages/pico_tui" },
 ]
 
 [package.metadata.requires-dev]
@@ -451,42 +436,57 @@ dev = [
 ]
 
 [[package]]
-name = "pico-cli-sdk"
-version = "0.1.0"
-source = { editable = "packages/pico_sdk" }
+name = "pico-cli-ai"
+version = "0.1.2"
+source = { editable = "packages/pico_ai" }
 dependencies = [
-    { name = "pico-ai" },
-    { name = "pico-core" },
+    { name = "httpx" },
     { name = "pydantic" },
 ]
 
 [package.metadata]
 requires-dist = [
-    { name = "pico-ai", editable = "packages/pico_ai" },
-    { name = "pico-core", editable = "packages/pico_core" },
+    { name = "httpx", specifier = ">=0.27" },
     { name = "pydantic", specifier = ">=2" },
 ]
 
 [[package]]
-name = "pico-core"
-version = "0.1.0"
+name = "pico-cli-core"
+version = "0.1.2"
 source = { editable = "packages/pico_core" }
 dependencies = [
     { name = "httpx" },
-    { name = "pico-ai" },
+    { name = "pico-cli-ai" },
     { name = "pydantic" },
 ]
 
 [package.metadata]
 requires-dist = [
     { name = "httpx", specifier = ">=0.27" },
-    { name = "pico-ai", editable = "packages/pico_ai" },
+    { name = "pico-cli-ai", editable = "packages/pico_ai" },
     { name = "pydantic", specifier = ">=2" },
 ]
 
 [[package]]
-name = "pico-tui"
-version = "0.1.0"
+name = "pico-cli-sdk"
+version = "0.1.2"
+source = { editable = "packages/pico_sdk" }
+dependencies = [
+    { name = "pico-cli-ai" },
+    { name = "pico-cli-core" },
+    { name = "pydantic" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "pico-cli-ai", editable = "packages/pico_ai" },
+    { name = "pico-cli-core", editable = "packages/pico_core" },
+    { name = "pydantic", specifier = ">=2" },
+]
+
+[[package]]
+name = "pico-cli-tui"
+version = "0.1.2"
 source = { editable = "packages/pico_tui" }
 dependencies = [
     { name = "pico-cli-sdk" },

pico_cli-0.1.0/IMPLEMENTATION_SUMMARY.md

@@ -1,80 +0,0 @@
-# Context Status Bar Implementation Summary
-
-## Overview
-Added a context status bar widget to the PicoCLI TUI that displays:
-- Provider name (e.g., "OpenRouter")
-- Model name (e.g., "nvidia/nemotron-3.5-lightning:free")
-- Thinking indicator (shown when the model is reasoning)
-- Context window progress bar (fills as context fills, color-coded by usage level)
-- Current token count (formatted with commas, e.g., "38,932")
-
-## Files Modified
-
-### 1. `packages/pico_core/src/pico_core/fsm.py`
-- Added public `estimate_tokens()` method to `AgentLoop` class
-- This exposes the private `_estimate_tokens()` functionality
-
-### 2. `packages/pico_sdk/src/pico_sdk/session.py`
-- Added `provider_name` property to `AgentSession` class
-  - Extracts provider name from the provider class name
-  - Returns "OpenRouter" for OpenRouterProvider
-- Added `context_window` property to `AgentSession` class
-  - Returns the context window size from the agent loop
-- Added `estimate_tokens()` method to `AgentSession` class
-  - Returns current estimated token count from the agent loop
-
-### 3. `packages/pico_tui/src/pico_tui/status_bar.py` (NEW FILE)
-- Created `ContextStatusBar` widget extending Textual's `Static`
-- Features:
-  - Displays provider | model information
-  - Shows "thinking" indicator in yellow italic when active
-  - Renders a 20-character progress bar for context window usage
-  - Color-codes the progress bar:
-    - Green: 0-50% usage (░ character)
-    - Yellow: 50-70% usage (▒ character)
-    - Orange: 70-90% usage (▓ character)
-    - Red: 90-100% usage (█ character)
-  - Shows token count with comma formatting in cyan
-- Methods:
-  - `on_mount()`: Renders initial display after widget mount
-  - `update_info()`: Updates all status information
-  - `set_thinking()`: Updates thinking state
-  - `_update_display()`: Renders the status bar with Rich Text
-
-### 4. `packages/pico_tui/src/pico_tui/app.py`
-- Imported `ContextStatusBar` widget
-- Added CSS styling for `#status-bar`:
-  - Docked to bottom
-  - Height: 1 line
-  - Background: $surface color
-  - Padding: 0 1
-- Added `ContextStatusBar` to `compose()` method after Input widget
-- Added `_update_status_bar()` method to update the status bar with current session info
-- Updated `on_mount()` to call `_update_status_bar()` on initialization
-- Updated `_run_prompt()` to call `_update_status_bar()` when streaming starts
-- Updated `_stream_worker()` to call `_update_status_bar()` when streaming completes
-
-### 5. `tests/test_status_bar.py` (NEW FILE)
-- Added 3 tests for the ContextStatusBar widget:
-  - `test_status_bar_initialization`: Verifies default values
-  - `test_status_bar_stores_info`: Verifies info storage
-  - `test_status_bar_set_thinking`: Verifies thinking state updates
-
-## Test Results
-All 92 tests pass successfully, including:
-- 19 existing TUI tests
-- 3 new status bar tests
-- All other existing tests remain passing
-
-## Usage
-The status bar automatically appears below the input bar in the TUI and updates:
-- On application startup (shows initial provider, model, and 0 tokens)
-- When a prompt is submitted (shows "thinking" indicator)
-- When streaming completes (updates token count and hides "thinking")
-- When the model changes via `/model` command
-
-The status bar provides real-time visibility into:
-- Which AI provider and model is being used
-- Whether the model is currently thinking/reasoning
-- How much of the context window is being used
-- The exact token count in the current context