gemcode 0.3.1__tar.gz → 0.3.4__tar.gz

{gemcode-0.3.1/src/gemcode.egg-info → gemcode-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemcode
-Version: 0.3.1
+Version: 0.3.4
 Summary: Local-first coding agent on Google Gemini + ADK
 Author: GemCode Contributors
 License:                                  Apache License

{gemcode-0.3.1 → gemcode-0.3.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gemcode"
-version = "0.3.1"
+version = "0.3.4"
 description = "Local-first coding agent on Google Gemini + ADK"
 readme = "README.md"
 requires-python = ">=3.11"

gemcode-0.3.4/src/gemcode/__init__.py

@@ -0,0 +1,5 @@
+"""GemCode: Gemini + ADK coding agent."""
+
+from gemcode.version import get_version
+
+__version__ = get_version()

{gemcode-0.3.1 → gemcode-0.3.4}/src/gemcode/agent.py

@@ -56,11 +56,28 @@ def _load_gemini_md(project_root: Path) -> str:
   return ""
 
 
+def _build_runtime_facts(cfg: GemCodeConfig) -> str:
+  """
+  Injected every session so the model does not hallucinate deployment, permissions,
+  or "how to switch Pro" the way a product-agnostic base prompt would.
+  """
+  root = cfg.project_root.resolve()
+  model = (getattr(cfg, "model", None) or "").strip() or "(default)"
+  return f"""## Runtime facts (authoritative for this session)
+- **Project root** — every filesystem tool path is relative to: `{root}`
+- **Model id in use:** `{model}`. Changing it requires restarting GemCode with `--model <id>` or env `GEMCODE_MODEL`, or using `/model` in the REPL for routing info. Shell: `gemcode list-models` lists candidate ids.
+- **UI banner** phrases such as "GemCode Pro" are **terminal marketing**, not a separate API tier or model you enable from chat.
+- **Env toggles** (`GEMCODE_ENABLE_COMPUTER_USE`, `GEMCODE_MODEL`, etc.) affect only the **OS process** that launched `gemcode`. Pasting `VAR=1` in chat does **not** reconfigure a running session—tell the user to export in their shell, use project `.env`, or restart the CLI.
+- **Working in subfolders** — use tools: e.g. `list_directory("Desktop")`, `glob_files("**/query.ts")`, `read_file("testing/ai-edtech-app/src/app/page.tsx")`, or `run_command` with `cwd_subdir`. Never claim the sandbox cannot reach a subpath unless a tool returned an explicit error."""
+
+
 def build_instruction(cfg: GemCodeConfig) -> str:
   # Layered instructions mirror the *structure* of mature coding agents (scope,
   # task interpretation, tool choice, parallelism, risk)—not proprietary text.
-  base = """You are GemCode, an expert software engineering agent.
-You operate only inside the user's project directory (current working directory).
+  base = f"""You are GemCode, an expert software engineering agent.
+You run locally via the GemCode CLI and call **Google Gemini** through its API. You are the same agent stack the user launched—not a hosted "portal" you can reconfigure from inside the conversation.
+
+{_build_runtime_facts(cfg)}
 
 ## How to interpret requests
 - Treat every message as a **software engineering** task in this repo unless the user clearly wants something else. If the instruction is vague ("fix it", "rename that", "the config", "see codebase"), **infer intent from the repository**: search, read, then act—do not answer with abstract advice when concrete files exist.
@@ -74,11 +91,15 @@ You operate only inside the user's project directory (current working directory)
 - **`run_command` rules (critical):**
   - `command` must be a **single executable basename** (e.g. `npm`, `npx`, `mkdir`) — **not** `bash`, `sh`, or `cd foo && ...`.
   - Pass argv as `args` (list). To run a command **inside** a subfolder (e.g. Next app in `testing/`), set **`cwd_subdir`** to that relative path (e.g. `"testing"`) and run `npm run dev` there — **never** simulate `cd` with `bash`.
-  - **Scaffolding** (`create-next-app`, etc.): many CLIs require non-interactive mode — pass **`extra_env`** like `{"CI": "1"}` and/or flags supported by that tool (`--yes` where documented).
+  - **Scaffolding** (`create-next-app`, etc.): many CLIs require non-interactive mode — pass **`extra_env_keys`** / **`extra_env_values`** as parallel lists (e.g. `["CI"]` and `["1"]`) and/or flags supported by that tool (`--yes` where documented).
   - **Dev servers** (`npm run dev`, `vite`, etc.) run until stopped: use **`background=True`** so the process detaches; otherwise the tool may time out. You cannot open a *new OS terminal window* from here—background start is the supported way to keep running.
 - **Parallelize:** when you need several **independent** reads or searches (no output from one is required to form the next call), issue them together in one turn so the user gets answers faster. When step B depends on step A's result, run **sequentially**.
 - **Deletion:** use `delete_file` for a single file under the project root; reserve `rm` via `run_command` for unusual cases.
 - **Autonomy:** explore with `list_directory` ("."), `glob_files` (e.g. `**/*.md`, `**/*keyword*`), and `grep_content` before asking "which file?". Prefer widening your search over interrogating the user.
+- **Workspace scope:** All file tools use paths **relative to the project root** (the current working directory GemCode was started in). That root may be the user's home folder—then subfolders like `Desktop`, `Desktop/code`, or `Documents` are **inside** the sandbox. **Call** `list_directory("Desktop")` or `glob_files("**/*name*.ts")` instead of assuming access is blocked. **Only** treat access as denied when a tool returns an `error` string—**do not** invent extra "security" or "permission" policies the runtime did not report.
+- **Finding files:** For a basename like `query.ts`, try several globs in one turn when needed: `**/query.ts`, `**/*query.ts`, `**/*_query.ts`. If the user names a parent path (e.g. Desktop), **list that path** and narrow down. If a search fails, **change the pattern** (broader `**`, partial stem) before saying "not found".
+- **Agentic turns:** One user message can include **many** model↔tool rounds (bounded by runtime). If the task is **not** done after the first tool (e.g. you only searched, or read one file), **keep going** with more tools in the same turn until you can answer or have a clear blocker—do not stop at the first tool call unless it fully satisfies the request.
+- **Model output:** If a response is mostly **function calls** without prose, that is normal—execute tools, then synthesize a clear **text** answer for the user once you have enough information.
 
 ## Risk and permissions
 - Destructive or irreversible actions (deletes, force pushes, anything that wipes data) deserve a clear, honest description; the runtime may require explicit user approval. If the session uses **inline** approval, wait for it—do not instruct the user to "re-run with --yes" unless that is actually required by the environment.
@@ -86,7 +107,8 @@ You operate only inside the user's project directory (current working directory)
 
 ## Communication
 - Before the first tool call in a turn, give a **short** line on what you are about to do. Assume the user does not see raw tool internals—summarize outcomes in plain language.
-- Prefer small, testable edits and accurate reporting over breadth."""
+- Prefer small, testable edits and accurate reporting over breadth.
+- If the user pastes **UI copy** or noise (e.g. fragments of a webpage, marketing lines, or mixed headings), infer intent: they often want that clutter **removed or replaced** in source—read the file, then edit the real `page.tsx` (or relevant file), do not treat pasted UI strings as a dialogue prompt."""
 
   tool_manifest = build_tool_manifest(cfg)
 

{gemcode-0.3.1 → gemcode-0.3.4}/src/gemcode/config.py

@@ -295,3 +295,9 @@ def load_cli_environment() -> None:
   from gemcode.credentials import apply_saved_google_api_key_to_environ
 
   apply_saved_google_api_key_to_environ()
+
+  from gemcode.logging_config import apply_gemcode_logging_filters
+  from gemcode.version import get_version
+
+  os.environ.setdefault("GEMCODE_VERSION", get_version())
+  apply_gemcode_logging_filters()

gemcode-0.3.4/src/gemcode/logging_config.py

@@ -0,0 +1,44 @@
+"""
+Tune third-party loggers for interactive CLI/TUI (expected Gemini function-call noise).
+"""
+
+from __future__ import annotations
+
+import logging
+import os
+
+
+def apply_gemcode_logging_filters() -> None:
+  """
+  google.genai logs logger.warning when .text strips non-text parts (normal with tools).
+
+  That uses the **logging** module, not warnings.warn — filterwarnings cannot silence it.
+  Set GEMCODE_VERBOSE_GENAI=1 to keep those lines.
+  """
+  if os.environ.get("GEMCODE_VERBOSE_GENAI", "").lower() in (
+      "1",
+      "true",
+      "yes",
+      "on",
+  ):
+    return
+
+  class _Filter(logging.Filter):
+    def filter(self, record: logging.LogRecord) -> bool:
+      try:
+        msg = record.getMessage()
+      except Exception:
+        return True
+      if "non-text parts in the response" in msg:
+        return False
+      if "multiple candidates in the response" in msg:
+        return False
+      return True
+
+  f = _Filter()
+  for name in (
+      "google_genai.types",
+      "google_genai",
+      "google.genai.types",
+  ):
+    logging.getLogger(name).addFilter(f)

{gemcode-0.3.1 → gemcode-0.3.4}/src/gemcode/repl_commands.py

@@ -14,6 +14,7 @@ from typing import Any, Iterable
 
 from gemcode.config import GemCodeConfig
 from gemcode.trust import is_trusted_root
+from gemcode.version import get_version
 
 
 def _is_executable(p: Path) -> bool:
@@ -52,7 +53,9 @@ def format_doctor_lines(cfg: GemCodeConfig) -> list[str]:
   except Exception as e:
     lines.append(f"  project_root: ERROR {e}")
   lines.append(f"  folder_trusted: {is_trusted_root(cfg.project_root)}")
-  lines.append(f"  GEMCODE_VERSION: {os.environ.get('GEMCODE_VERSION', '(unset)')}")
+  lines.append(
+      f"  gemcode_version: {os.environ.get('GEMCODE_VERSION', get_version())}"
+  )
   return lines
 
 
@@ -157,6 +160,7 @@ def format_tools_lines(
 def slash_help_lines() -> list[str]:
   return [
       "Slash commands:",
+      "  (CLI) gemcode -C DIR  Use a project folder as root (recommended vs. ~ )",
       "  (CLI) gemcode login   Save or change API key (~/.gemcode/credentials.json)",
       "  /help                 Show this help",
       "  /status               Show current session/model info",

{gemcode-0.3.1 → gemcode-0.3.4}/src/gemcode/tool_prompt_manifest.py

@@ -120,7 +120,7 @@ You may call tools as follows:
   Notes:
   - Prefer `python -m pip ...` (or `python3 -m pip ...`) so installs stay in the active virtualenv.
   - Do not assume sudo/system package manager access.
-  - `run_command` supports `cwd_subdir` (relative path under the project) instead of `cd`/`bash`; use `extra_env` (e.g. CI=1) for non-interactive installers; use `background=true` for long-running dev servers.
+  - `run_command` supports `cwd_subdir` (relative path under the project) instead of `cd`/`bash`; use parallel `extra_env_keys` / `extra_env_values` (e.g. ["CI"] and ["1"]) for non-interactive installers; use `background=true` for long-running dev servers.
 
 Optional capability tools:
 - Deep research built-ins are {'ON' if deep_research_on else 'OFF'}.

{gemcode-0.3.1 → gemcode-0.3.4}/src/gemcode/tools/shell.py

@@ -7,7 +7,6 @@ import re
 import shutil
 import subprocess
 from pathlib import Path
-from typing import Any
 
 from google.adk.tools.tool_context import ToolContext
 
@@ -18,12 +17,12 @@ from gemcode.tools.shell_gate import consume_confirmed_shell_if_matches
 from gemcode.trust import is_trusted_root
 
 
-def _merge_child_env(extra: dict[str, Any] | None) -> dict[str, str]:
-  """Merge a small set of env vars into os.environ for the child (e.g. CI=1)."""
+def _merge_child_env(keys: list[str], values: list[str]) -> dict[str, str]:
+  """Merge parallel key/value lists into os.environ (Gemini API rejects dict-typed tool params)."""
   out = {**os.environ}
-  if not extra:
+  if not keys and not values:
     return out
-  for k, v in extra.items():
+  for k, v in zip(keys, values):
     if not isinstance(k, str) or not isinstance(v, str):
       continue
     if not re.match(r"^[A-Za-z_][A-Za-z0-9_]*$", k):
@@ -45,7 +44,8 @@ def make_run_command(cfg: GemCodeConfig):
     tool_context: ToolContext | None = None,
     cwd_subdir: str = ".",
     background: bool = False,
-    extra_env: dict[str, str] | None = None,
+    extra_env_keys: list[str] | None = None,
+    extra_env_values: list[str] | None = None,
   ) -> dict:
     """
     Run an allowlisted executable with arguments.
@@ -57,8 +57,9 @@ def make_run_command(cfg: GemCodeConfig):
     For long-running servers (e.g. `npm run dev`), set `background=True` to start
     a detached process and return its PID (non-interactive; no TTY for the child).
 
-    Optional `extra_env` merges env vars for the child (e.g. {"CI": "1"} for
-    non-interactive scaffolding tools).
+    Optional `extra_env_keys` / `extra_env_values` are parallel lists (same length)
+    merged into the child environment (e.g. keys ["CI"], values ["1"] for
+    non-interactive scaffolding tools). Omit both to use the default environment.
     """
     if not trusted:
       return {"error": "Project folder is not trusted. Re-run GemCode and approve folder trust."}
@@ -111,7 +112,17 @@ def make_run_command(cfg: GemCodeConfig):
           )
       }
 
-    child_env = _merge_child_env(extra_env)
+    ek = list(extra_env_keys or [])
+    ev = list(extra_env_values or [])
+    if len(ek) != len(ev):
+      return {
+          "error": (
+              "extra_env_keys and extra_env_values must be parallel lists of the same length "
+              "(one value per key)."
+          ),
+      }
+
+    child_env = _merge_child_env(ek, ev)
 
     if background:
       try:

{gemcode-0.3.1 → gemcode-0.3.4}/src/gemcode/tui/app.py

@@ -8,8 +8,11 @@ import warnings
 from datetime import datetime
 
 from gemcode.capability_routing import apply_capability_routing
+from gemcode.config import load_cli_environment
 from gemcode.model_routing import pick_effective_model
 from gemcode.repl_slash import process_repl_slash
+from gemcode.tui.scrollback import format_tool_call_extras
+from gemcode.version import get_version
 
 
 async def run_gemcode_tui(
@@ -26,6 +29,7 @@ async def run_gemcode_tui(
   ``extra_tools`` matches the runner (e.g. MCP toolsets when ``--mcp``) so
   ``/tools`` lists the same inventory as the agent.
   """
+  load_cli_environment()
   session_state = {"id": session_id}
 
   from prompt_toolkit.application import Application
@@ -65,7 +69,7 @@ async def run_gemcode_tui(
     height=D(weight=1),
   )
   input_box = TextArea(
-    prompt="> ",
+    prompt="❯ ",
     multiline=True,
     wrap_lines=True,
     height=D(min=3, max=6, preferred=3),
@@ -178,9 +182,9 @@ async def run_gemcode_tui(
 
   def _set_input_prompt() -> None:
     if pending_confirm.get("future") is not None:
-      input_box.prompt = "perm> "
+      input_box.prompt = "⎿ perm "
     else:
-      input_box.prompt = "> "
+      input_box.prompt = "❯ "
 
   def _input_help_text():
     if pending_confirm.get("future") is not None:
@@ -272,7 +276,10 @@ async def run_gemcode_tui(
         return s[: max(0, w - 1)] + "…"
       return s + (" " * (w - len(s)))
 
-    mid_title = "│" + pad(f" GemCode  v{os.environ.get('GEMCODE_VERSION', '0.1.0')}", width - 2) + "│"
+    mid_title = "│" + pad(
+        f" GemCode  v{os.environ.get('GEMCODE_VERSION', get_version())}",
+        width - 2,
+    ) + "│"
 
     welcome = f"Welcome back {_uname()}!"
     bot = [
@@ -571,7 +578,11 @@ async def run_gemcode_tui(
           name = getattr(fc, "name", "") or ""
           if name == REQUEST_CONFIRMATION_FC:
             continue
-          _box("tool", [name])
+          extra = format_tool_call_extras(fc)
+          if extra:
+            _box("tool", [name, extra])
+          else:
+            _box("tool", [name])
 
       # Token-budget reset matches invoke.run_turn behavior.
       state_delta = None
@@ -639,7 +650,7 @@ async def run_gemcode_tui(
         if not confirmation_fcs:
           # Now that we know no confirmation is needed, render buffered text.
           if buffered:
-            append_inline("GemCode: ")
+            append_inline("⎿ GemCode: ")
             await typewrite("".join(buffered))
           break
 
@@ -690,6 +701,27 @@ async def run_gemcode_tui(
       if not assistant_started:
         append_inline("(no text output)")
       append("")  # newline after assistant turn
+      if os.environ.get("GEMCODE_TUI_TURN_FOOTER", "1").lower() in (
+          "1",
+          "true",
+          "yes",
+          "on",
+      ):
+        sid = session_state["id"]
+        sid_short = sid[:8] if len(sid) >= 8 else sid
+        model = getattr(cfg, "model", "") or ""
+        append(f"\033[2m · {model} · session {sid_short}\033[0m")
+      if os.environ.get("GEMCODE_TUI_TURN_RULE", "1").lower() in (
+          "1",
+          "true",
+          "yes",
+          "on",
+      ):
+        try:
+          cw = app.output.get_size().columns
+        except Exception:
+          cw = 80
+        append("\033[2m" + ("─" * max(40, min(cw - 2, 200))) + "\033[0m")
     except Exception as e:
       append(f"GemCode: error: {e}\n")
 

{gemcode-0.3.1 → gemcode-0.3.4}/src/gemcode/tui/scrollback.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import asyncio
+import json
 import os
 import sys
 from dataclasses import dataclass
@@ -9,8 +10,88 @@ from google.adk.agents.run_config import RunConfig
 from google.genai import types
 
 from gemcode.capability_routing import apply_capability_routing
+from gemcode.config import load_cli_environment
 from gemcode.model_routing import pick_effective_model
 from gemcode.repl_slash import process_repl_slash
+from gemcode.version import get_version
+from gemcode.workspace_hints import narrow_workspace_tip
+
+_ADK_REQUEST_CONFIRMATION = "adk_request_confirmation"
+
+
+def format_tool_call_extras(fc) -> str:
+  """
+  One-line summary of tool arguments for Claude-style ``[tool] name …`` lines.
+
+  Parses ``FunctionCall.args`` / nested ``originalFunctionCall.args`` when present.
+  """
+  try:
+    raw = getattr(fc, "args", None)
+    if raw is None:
+      return ""
+    if isinstance(raw, str):
+      try:
+        raw = json.loads(raw)
+      except Exception:
+        return ""
+    if not isinstance(raw, dict):
+      return ""
+    inner: dict = {}
+    orig = raw.get("originalFunctionCall")
+    if isinstance(orig, dict):
+      a = orig.get("args")
+      if isinstance(a, dict):
+        inner = a
+      elif isinstance(a, str):
+        try:
+          inner = json.loads(a) if a.strip() else {}
+        except Exception:
+          inner = {}
+    if not inner:
+      inner = {
+          k: v
+          for k, v in raw.items()
+          if k not in ("originalFunctionCall", "toolConfirmation")
+      }
+    if not isinstance(inner, dict) or not inner:
+      return ""
+    for key in (
+        "path",
+        "glob_pattern",
+        "pattern",
+        "command",
+        "query",
+        "url",
+        "file_path",
+        "target_file",
+    ):
+      if key in inner and inner[key] not in (None, ""):
+        v = str(inner[key])
+        if len(v) > 80:
+          v = v[:77] + "..."
+        return f"{key}={v}"
+    parts: list[str] = []
+    for k, v in list(inner.items())[:4]:
+      if k in ("originalFunctionCall",):
+        continue
+      sv = str(v)
+      if len(sv) > 40:
+        sv = sv[:37] + "..."
+      parts.append(f"{k}={sv}")
+    return " ".join(parts) if parts else ""
+  except Exception:
+    return ""
+
+
+def _events_had_non_confirmation_tools(events: list) -> bool:
+  for ev in events:
+    try:
+      for fc in ev.get_function_calls() or []:
+        if getattr(fc, "name", "") != _ADK_REQUEST_CONFIRMATION:
+          return True
+    except Exception:
+      continue
+  return False
 
 
 @dataclass(frozen=True)
@@ -72,7 +153,7 @@ def _hr(ch: str = "─") -> str:
 
 def _dashboard(cfg) -> str:
   w = _term_width()
-  title = f" GemCode v{os.environ.get('GEMCODE_VERSION', '0.1.0')} "
+  title = f" GemCode v{os.environ.get('GEMCODE_VERSION', get_version())} "
   left_w = (w - 4) * 2 // 3
   right_w = (w - 4) - left_w
 
@@ -116,6 +197,9 @@ def _dashboard(cfg) -> str:
     lines.append(
       "│ " + pad(left[i], left_w) + " │ " + pad(right[i], right_w) + " │"
     )
+  nt = narrow_workspace_tip(getattr(cfg, "project_root"))
+  if nt:
+    lines.append("│" + pad(f" {nt}", w - 2) + "│")
   lines.append(box_bot)
   lines.append("")
   lines.append("  ↑ GemCode Pro now supports larger contexts · faster streaming")
@@ -134,6 +218,7 @@ async def run_gemcode_scrollback_tui(
   - Tool calls are shown as a short "internal state" block.
   - Permission prompts are inline: type y/n at the prompt.
   """
+  load_cli_environment()
   os.environ["GEMCODE_TUI_ACTIVE"] = "1"
 
   ansi = _Ansi(
@@ -179,14 +264,14 @@ async def run_gemcode_scrollback_tui(
       sys.stdout.flush()
       await asyncio.sleep(char_delay_ms / 1000.0)
 
-  REQUEST_CONFIRMATION_FC = "adk_request_confirmation"
+  REQUEST_CONFIRMATION_FC = _ADK_REQUEST_CONFIRMATION
 
   def _get_confirmation_fcs(events: list) -> list[types.FunctionCall]:
     out: list[types.FunctionCall] = []
     for ev in events:
       try:
         for fc in ev.get_function_calls() or []:
-          if getattr(fc, "name", None) == REQUEST_CONFIRMATION_FC:
+          if getattr(fc, "name", None) == _ADK_REQUEST_CONFIRMATION:
             out.append(fc)
       except Exception:
         continue
@@ -212,9 +297,16 @@ async def run_gemcode_scrollback_tui(
       fcs = []
     for fc in fcs:
       name = getattr(fc, "name", "") or ""
-      if name == REQUEST_CONFIRMATION_FC:
+      if name == _ADK_REQUEST_CONFIRMATION:
         continue
-      print(f"  ⎿  {ansi.blue_tool}[tool]{ansi.reset} {ansi.bold}{name}{ansi.reset}")
+      extra = format_tool_call_extras(fc)
+      if extra:
+        print(
+            f"  ⎿  {ansi.blue_tool}[tool]{ansi.reset} {ansi.bold}{name}{ansi.reset} "
+            f"{ansi.dim}{extra}{ansi.reset}"
+        )
+      else:
+        print(f"  ⎿  {ansi.blue_tool}[tool]{ansi.reset} {ansi.bold}{name}{ansi.reset}")
 
   run_config = (
     RunConfig(max_llm_calls=cfg.max_llm_calls)
@@ -263,6 +355,7 @@ async def run_gemcode_scrollback_tui(
 
     while True:
       events: list = []
+      assistant_wrote_text = False
       kwargs = dict(
           user_id="local", session_id=current_session_id, new_message=current_message
       )
@@ -281,10 +374,17 @@ async def run_gemcode_scrollback_tui(
           for part in ev.content.parts:
             delta = getattr(part, "text", None)
             if delta:
+              assistant_wrote_text = True
               await typewrite(delta)
         except Exception:
           continue
 
+      if not assistant_wrote_text and _events_had_non_confirmation_tools(events):
+        await typewrite(
+            f"{ansi.dim}(Tools ran without a text reply in this step; "
+            f"the run may continue in the background. Ask a follow-up if you need more.){ansi.reset}"
+        )
+
       confirmation_fcs = _get_confirmation_fcs(events)
       if not confirmation_fcs:
         break
@@ -331,5 +431,25 @@ async def run_gemcode_scrollback_tui(
       do_reset = False
 
     print("")
+    if os.environ.get("GEMCODE_TUI_TURN_FOOTER", "1").lower() in (
+        "1",
+        "true",
+        "yes",
+        "on",
+    ):
+      sid = (
+          current_session_id[:8]
+          if len(current_session_id) >= 8
+          else current_session_id
+      )
+      model = getattr(cfg, "model", "") or ""
+      print(f"{ansi.dim}  · {model} · session {sid}{ansi.reset}")
+    if os.environ.get("GEMCODE_TUI_TURN_RULE", "1").lower() in (
+        "1",
+        "true",
+        "yes",
+        "on",
+    ):
+      print(f"{ansi.dim}{_hr(ch='─')}{ansi.reset}")
     print("")
 

gemcode-0.3.4/src/gemcode/version.py

@@ -0,0 +1,15 @@
+"""Installed package version (PyPI / wheel metadata)."""
+
+from __future__ import annotations
+
+try:
+  from importlib.metadata import PackageNotFoundError, version
+except ImportError:  # pragma: no cover
+  from importlib_metadata import PackageNotFoundError, version
+
+
+def get_version() -> str:
+  try:
+    return version("gemcode")
+  except PackageNotFoundError:
+    return "0.0.0"

gemcode-0.3.4/src/gemcode/workspace_hints.py

@@ -0,0 +1,23 @@
+"""UX hints when the project root is unusually broad (e.g. user home)."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+
+def project_root_is_user_home(project_root: Path) -> bool:
+  try:
+    return project_root.resolve() == Path.home().resolve()
+  except OSError:
+    return False
+
+
+def narrow_workspace_tip(project_root: Path) -> str | None:
+  """
+  One-line suggestion when GemCode is anchored at ~ so searches span the whole account.
+  """
+  if not project_root_is_user_home(project_root):
+    return None
+  return (
+    "Tip: narrow the workspace — restart with: gemcode -C /path/to/your/repo"
+  )

{gemcode-0.3.1 → gemcode-0.3.4/src/gemcode.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemcode
-Version: 0.3.1
+Version: 0.3.4
 Summary: Local-first coding agent on Google Gemini + ADK
 Author: GemCode Contributors
 License:                                  Apache License

{gemcode-0.3.1 → gemcode-0.3.4}/src/gemcode.egg-info/SOURCES.txt

@@ -21,6 +21,7 @@ src/gemcode/invoke.py
 src/gemcode/kairos_daemon.py
 src/gemcode/limits.py
 src/gemcode/live_audio_engine.py
+src/gemcode/logging_config.py
 src/gemcode/mcp_loader.py
 src/gemcode/modality_tools.py
 src/gemcode/model_errors.py
@@ -37,7 +38,9 @@ src/gemcode/tool_prompt_manifest.py
 src/gemcode/tool_registry.py
 src/gemcode/tools_inspector.py
 src/gemcode/trust.py
+src/gemcode/version.py
 src/gemcode/vertex.py
+src/gemcode/workspace_hints.py
 src/gemcode.egg-info/PKG-INFO
 src/gemcode.egg-info/SOURCES.txt
 src/gemcode.egg-info/dependency_links.txt
@@ -71,6 +74,7 @@ src/gemcode/tui/scrollback.py
 src/gemcode/web/__init__.py
 src/gemcode/web/claude_sse_adapter.py
 src/gemcode/web/terminal_repl.py
+tests/test_agent_instruction.py
 tests/test_autocompact.py
 tests/test_capability_routing.py
 tests/test_claude_web_adapter_sse.py
@@ -95,4 +99,5 @@ tests/test_thinking_config.py
 tests/test_token_budget.py
 tests/test_tool_context_circulation.py
 tests/test_tools.py
-tests/test_tools_inspector.py
+tests/test_tools_inspector.py
+tests/test_workspace_hints.py

gemcode-0.3.4/tests/test_agent_instruction.py

@@ -0,0 +1,13 @@
+from pathlib import Path
+
+from gemcode.agent import build_instruction
+from gemcode.config import GemCodeConfig
+
+
+def test_instruction_includes_runtime_facts(tmp_path: Path) -> None:
+  cfg = GemCodeConfig(project_root=tmp_path, model="gemini-2.5-flash")
+  text = build_instruction(cfg)
+  assert str(tmp_path.resolve()) in text
+  assert "gemini-2.5-flash" in text
+  assert "list-models" in text
+  assert "GEMCODE_MODEL" in text

{gemcode-0.3.1 → gemcode-0.3.4}/tests/test_tools.py

@@ -118,6 +118,24 @@ def test_run_command_background_returns_pid(tmp_path: Path, monkeypatch) -> None
   assert isinstance(out.get("pid"), int)
 
 
+def test_run_command_extra_env_merges(tmp_path: Path, monkeypatch) -> None:
+  monkeypatch.setenv("GEMCODE_HOME", str(tmp_path / ".gemstate"))
+  trust_root(tmp_path, trusted=True)
+  cfg = GemCodeConfig(project_root=tmp_path)
+  run_command = make_run_command(cfg)
+  ctx = MagicMock()
+  ctx.state = {HITL_STICKY_SESSION_KEY: True}
+  out = run_command(
+      "python3",
+      ["-c", "import os; print(os.environ.get('GEMCODE_TEST_EXTRA', ''))"],
+      extra_env_keys=["GEMCODE_TEST_EXTRA"],
+      extra_env_values=["ok"],
+      tool_context=ctx,
+  )
+  assert out.get("exit_code") == 0
+  assert "ok" in (out.get("stdout") or "")
+
+
 def test_delete_file(tmp_path: Path, monkeypatch) -> None:
   monkeypatch.setenv("GEMCODE_HOME", str(tmp_path / ".gemstate"))
   trust_root(tmp_path, trusted=True)

gemcode-0.3.4/tests/test_workspace_hints.py

@@ -0,0 +1,16 @@
+from pathlib import Path
+
+from gemcode import workspace_hints
+
+
+def test_narrow_tip_none_for_non_home(tmp_path: Path) -> None:
+  assert workspace_hints.narrow_workspace_tip(tmp_path) is None
+  assert workspace_hints.project_root_is_user_home(tmp_path) is False
+
+
+def test_narrow_tip_for_home_directory() -> None:
+  home = Path.home()
+  assert workspace_hints.project_root_is_user_home(home) is True
+  tip = workspace_hints.narrow_workspace_tip(home)
+  assert tip is not None
+  assert "gemcode -C" in tip

gemcode-0.3.1/src/gemcode/__init__.py

@@ -1,3 +0,0 @@
-"""GemCode: Gemini + ADK coding agent."""
-
-__version__ = "0.1.0"