gemcode 0.3.77__py3-none-any.whl → 0.3.78__py3-none-any.whl

gemcode/agent.py

@@ -27,11 +27,49 @@ from gemcode.limits import make_before_model_limits_callback, make_before_model_
 from gemcode.thinking import build_thinking_config
 from gemcode.tools import build_function_tools
 from gemcode.tool_prompt_manifest import build_tool_manifest
-from gemcode.skills import build_skill_manifest_text
+from gemcode.skills import (
+  build_skill_manifest_text,
+  expand_skill_text,
+  list_supporting_files,
+  load_skill,
+)
 from gemcode.output_styles import build_output_style_section
 from gemcode.rules import build_rules_section
 
 
+def _build_session_loaded_skills_section(cfg: GemCodeConfig) -> str:
+  """Full bodies for GemSkills the user loaded with /gemskill (session-scoped)."""
+  names = list(getattr(cfg, "session_loaded_skill_names", None) or [])
+  if not names:
+    return ""
+  sid = getattr(cfg, "session_skill_expand_session_id", None) or ""
+  chunks: list[str] = []
+  seen: set[str] = set()
+  for raw in names:
+    sk_name = (raw or "").strip().lower()
+    if not sk_name or sk_name in seen:
+      continue
+    seen.add(sk_name)
+    s = load_skill(cfg.project_root, sk_name)
+    if s is None:
+      continue
+    expanded = expand_skill_text(s, arguments="", session_id=sid)
+    files = list_supporting_files(s)
+    head = f"### GemSkill: `/{s.meta.name}` (loaded for this session)\n\n"
+    chunk = head + expanded
+    if files:
+      chunk += f"\n\nSupporting files: {', '.join(files)}"
+    chunks.append(chunk)
+  if not chunks:
+    return ""
+  return (
+      "## Loaded GemSkills (this session)\n"
+      "The user explicitly loaded these skills with `/gemskill`. Follow their workflows "
+      "when the task matches their purpose; do not force them on unrelated requests.\n\n"
+      + "\n\n---\n\n".join(chunks)
+  )
+
+
 def build_global_instruction() -> str:
   """Global instruction applied to the entire agent tree (via ADK plugin)."""
   return (
@@ -888,6 +926,9 @@ You have two tools to persist project insights across sessions (auto-memory styl
   skill_manifest = build_skill_manifest_text(cfg.project_root)
   if skill_manifest:
     base = f"{base}\n\n{skill_manifest}"
+  loaded_skills = _build_session_loaded_skills_section(cfg)
+  if loaded_skills:
+    base = f"{base}\n\n{loaded_skills}"
   extra = _load_gemini_md(cfg.project_root)
   if extra.strip():
     return f"{base}\n\n## Project instructions (GEMINI.md)\n{extra}"

gemcode/autotune.py

@@ -3,8 +3,9 @@ from __future__ import annotations
 import subprocess
 import time
 from pathlib import Path
-from typing import Any
+from typing import Any, Iterable
 
+from gemcode.config import GemCodeConfig
 from gemcode.evals.harness import run_eval_suite, write_eval_record
 
 
@@ -47,11 +48,24 @@ def init_autotune(*, project_root: Path, tag: str) -> dict[str, Any]:
   return {"status": "created", "branch": branch}
 
 
-def run_autotune_eval(*, project_root: Path, include_llm: bool, model: str | None = None) -> dict[str, Any]:
+def run_autotune_eval(
+  *,
+  project_root: Path,
+  include_llm: bool,
+  model: str | None = None,
+  session_cfg: GemCodeConfig | None = None,
+  extra_tools: Iterable[Any] | None = None,
+) -> dict[str, Any]:
   """
   Run eval suite and persist last result to .gemcode/evals/last_eval.json.
   """
-  res = run_eval_suite(project_root=project_root, include_llm=include_llm, model=model)
+  res = run_eval_suite(
+    project_root=project_root,
+    include_llm=include_llm,
+    model=model,
+    session_cfg=session_cfg,
+    extra_tools=extra_tools,
+  )
   meta = {
     "ts": time.time(),
     "git_sha": _git_head_sha(project_root),

gemcode/cli.py

@@ -245,6 +245,13 @@ async def _run_repl(cfg: GemCodeConfig, session_id: str, *, use_mcp: bool) -> No
               file=sys.stderr,
           )
 
+    try:
+      from gemcode.repl_commands import install_readline_slash_completion
+
+      install_readline_slash_completion()
+    except Exception:
+      pass
+
     print(
       "GemCode CLI is running. Type your prompt and press Enter. (Ctrl+D to exit)",
       file=sys.stderr,
@@ -261,6 +268,7 @@ async def _run_repl(cfg: GemCodeConfig, session_id: str, *, use_mcp: bool) -> No
       if prompt_text in (":q", "quit", "exit", "/exit"):
         break
 
+      cfg.session_skill_expand_session_id = session_id
       slash = await process_repl_slash(
           cfg=cfg,
           runner=runner,
@@ -273,7 +281,16 @@ async def _run_repl(cfg: GemCodeConfig, session_id: str, *, use_mcp: bool) -> No
           break
         if slash.new_session_id is not None:
           session_id = slash.new_session_id
+          cfg.session_skill_expand_session_id = session_id
         if slash.skip_model_turn:
+          if slash.force_rebuild_runner:
+            try:
+              _c = runner.close()
+              if asyncio.iscoroutine(_c):
+                await _c
+            except Exception:
+              pass
+            runner = create_runner(cfg, extra_tools=None)
           continue
         prompt_text = slash.model_prompt or prompt_text
 

gemcode/config.py

@@ -212,6 +212,12 @@ class GemCodeConfig:
     default_factory=lambda: os.environ.get("GEMCODE_OUTPUT_STYLE") or None
   )
 
+  # GemSkills explicitly loaded via /gemskill — full bodies injected into the
+  # system instruction until cleared or the session is reset/resumed.
+  session_loaded_skill_names: list[str] = field(default_factory=list)
+  # Substitutes ${GEMCODE_SESSION_ID} when expanding loaded skills for prompts.
+  session_skill_expand_session_id: str | None = None
+
   # Modality toggles (tool injection + routing).
   enable_deep_research: bool = field(
     default_factory=lambda: _truthy_env("GEMCODE_ENABLE_DEEP_RESEARCH", default=False)

gemcode/evals/harness.py

@@ -3,14 +3,17 @@ from __future__ import annotations
 import asyncio
 import json
 import os
+import subprocess
+import sys
 import time
-from dataclasses import dataclass
+from dataclasses import dataclass, replace
 from pathlib import Path
-from typing import Any, Callable
+from typing import Any, Iterable
 
 from gemcode.config import GemCodeConfig, load_cli_environment
 from gemcode.invoke import run_turn
 from gemcode.session_runtime import create_runner
+from gemcode.tools_inspector import inspect_tools, smoke_tools
 
 
 @dataclass
@@ -21,11 +24,25 @@ class EvalResult:
   details: str = ""
 
 
-def _run_cmd(cmd: str, *, cwd: Path) -> tuple[int, str]:
-  import subprocess
-  p = subprocess.run(cmd, cwd=str(cwd), shell=True, capture_output=True, text=True)
-  out = (p.stdout or "") + (p.stderr or "")
-  return int(p.returncode), out
+def _discover_pytest_cwd(project_root: Path) -> tuple[Path, dict[str, str] | None] | None:
+  """
+  Return (cwd, env) for running pytest, or None if no tests tree found.
+
+  ``env`` is ``None`` to inherit the process environment; otherwise a full env dict.
+
+  Supports:
+  - Monorepo layout: <root>/gemcode/tests → cwd gemcode, PYTHONPATH=src
+  - Single-package layout: <root>/tests → cwd root
+  """
+  if (project_root / "tests").is_dir():
+    return project_root, None
+  gc = project_root / "gemcode"
+  if (gc / "tests").is_dir():
+    env = os.environ.copy()
+    prev = env.get("PYTHONPATH", "")
+    env["PYTHONPATH"] = "src" + (os.pathsep + prev if prev else "")
+    return gc, env
+  return None
 
 
 def _events_to_text(events: list) -> str:
@@ -72,28 +89,65 @@ def run_eval_suite(
   project_root: Path,
   include_llm: bool,
   model: str | None = None,
+  session_cfg: GemCodeConfig | None = None,
+  extra_tools: Iterable[Any] | None = None,
 ) -> dict[str, Any]:
   """
   Fixed evaluation harness (AutoResearch-style): deterministic gates + optional LLM golden prompts.
+
+  When ``session_cfg`` is set (e.g. from the REPL), tool smoke uses that config so flags match the live session.
   """
   t0 = time.time()
   load_cli_environment()
-  cfg = GemCodeConfig(project_root=project_root)
-  if model:
-    cfg.model = model
-    cfg.model_overridden = True
+  root = session_cfg.project_root if session_cfg is not None else project_root.resolve()
+  if session_cfg is not None:
+    cfg = replace(session_cfg, model=model, model_overridden=True) if model else session_cfg
+  else:
+    cfg = GemCodeConfig(project_root=project_root.resolve())
+    if model:
+      cfg.model = model
+      cfg.model_overridden = True
 
   results: list[EvalResult] = []
 
-  # Gate 1: tool schema smoke
-  rc, out = _run_cmd("PYTHONPATH=src python3 -m gemcode tools smoke", cwd=project_root / "gemcode")
-  results.append(EvalResult(name="tools_smoke", ok=(rc == 0), score=1.0 if rc == 0 else 0.0, details=out[-800:]))
-
-  # Gate 2: pytest if present
-  tests_dir = project_root / "gemcode" / "tests"
-  if tests_dir.is_dir():
-    rc2, out2 = _run_cmd("PYTHONPATH=src python3 -m pytest -q", cwd=project_root / "gemcode")
-    results.append(EvalResult(name="pytest", ok=(rc2 == 0), score=1.0 if rc2 == 0 else 0.0, details=out2[-1200:]))
+  # Gate 1: tool declaration smoke (in-process; matches REPL config when session_cfg is passed)
+  inspections = inspect_tools(cfg, extra_tools=extra_tools)
+  failures = smoke_tools(inspections)
+  ok_smoke = len(failures) == 0
+  smoke_details = ""
+  if failures:
+    smoke_details = "\n".join(
+      f"{f.name}: {f.declaration_error}" for f in failures[:40]
+    )
+  results.append(
+    EvalResult(
+      name="tools_smoke",
+      ok=ok_smoke,
+      score=1.0 if ok_smoke else 0.0,
+      details=smoke_details[-1200:],
+    )
+  )
+
+  # Gate 2: pytest if a tests/ tree exists under root or root/gemcode
+  pytest_target = _discover_pytest_cwd(root)
+  if pytest_target is not None:
+    cwd, env = pytest_target
+    p = subprocess.run(
+      [sys.executable, "-m", "pytest", "-q"],
+      cwd=str(cwd),
+      env=env,
+      capture_output=True,
+      text=True,
+    )
+    out2 = (p.stdout or "") + (p.stderr or "")
+    results.append(
+      EvalResult(
+        name="pytest",
+        ok=(p.returncode == 0),
+        score=1.0 if p.returncode == 0 else 0.0,
+        details=out2[-1200:],
+      )
+    )
 
   if include_llm:
     goldens = [

gemcode/repl_commands.py

@@ -196,6 +196,123 @@ def format_tools_lines(
   return lines
 
 
+# ---------------------------------------------------------------------------
+# Slash command registry for TUI (prompt_toolkit) + plain REPL (readline Tab).
+# One canonical name per feature where possible; a few shortcuts (e.g.
+# ``gemskill``) stay as their own row so Tab/TUI shows them. Other aliases
+# still work in ``process_repl_slash`` but are omitted here (see descriptions).
+# ---------------------------------------------------------------------------
+SLASH_COMMANDS: list[tuple[str, str]] = [
+    ("add-dir",     "Extra read/search roots  ·  /add_dir works too"),
+    ("append",      "Iterate a file  ·  /append gemskill <name> <request>"),
+    ("audit",       "Tail audit.log  ·  /logs same"),
+    ("autotune",    "Branch + eval ledger  ·  /autotune init <tag>  ·  /autotune eval"),
+    ("batch",       "Built-in batch GemSkill (large parallel changes)"),
+    ("budget",      "Per-turn token budget  ·  /token-budget same"),
+    ("caps",        "Capabilities  ·  /capabilities /capability same"),
+    ("clear",       "Fresh session  ·  same as /session new"),
+    ("code",        "Toggle ADK BuiltInCodeExecutor (sandboxed Python)"),
+    ("compact",     "Context compaction / summarization"),
+    ("computer",    "Browser automation  ·  /browser same"),
+    ("config",      "Dump active configuration"),
+    ("context",     "Context pressure + token breakdown"),
+    ("cost",        "Session token usage + estimated cost"),
+    ("create",      "New GemSkill file  ·  /create gemskill <name> [description]"),
+    ("gemskill",    "Load skill into session prompt  ·  /gemskill <name>  ·  list  ·  clear"),
+    ("curated",     "Curated memory snapshot  ·  /memory-files /memoryfiles same"),
+    ("diff",        "Git diff or checkpoint diff"),
+    ("doctor",      "Environment sanity check"),
+    ("embeddings",  "Semantic file search  ·  /embed same"),
+    ("eval",        "Eval gates (tools + pytest)  ·  /eval llm optional"),
+    ("exit",        "Leave the REPL  ·  /quit same"),
+    ("help",        "Short help  ·  /? same"),
+    ("hooks",       "Post-turn hook configuration"),
+    ("init",        "Generate GEMINI.md project instructions"),
+    ("kaira",       "Background job scheduler — how to run gemcode kaira"),
+    ("limits",      "Execution limits (calls, context, …)"),
+    ("live-audio",  "How to run gemcode live-audio  ·  /liveaudio same"),
+    ("login",       "How to run gemcode login (API key)"),
+    ("maps",        "Maps grounding  ·  /maps on|off  ·  /map same"),
+    ("memory",      "Persistent memory  ·  /memory on|off"),
+    ("mode",        "Model mode: fast|balanced|quality|auto"),
+    ("model",       "Model info / override  ·  /models same"),
+    ("notes",       ".gemcode/notes.md  ·  /notes clear  ·  /notes edit"),
+    ("permissions", "Permission + HITL  ·  /perm /permission same"),
+    ("plan",        "Plan-before-act mode"),
+    ("research",    "Deep research tools  ·  /research on|off"),
+    ("review",      "Parallel code review"),
+    ("rewind",      "Checkpoints  ·  /checkpoint same"),
+    ("rules",       "Rule files from .gemcode/rules/"),
+    ("session",     "Session id / list / resume / new"),
+    ("skill",       "Load or show a GemSkill"),
+    ("skills",      "List GemSkills"),
+    ("status",      "Model, capabilities, thinking, limits"),
+    ("style",       "Output styles  ·  /style <name>|off"),
+    ("thinking",    "Thinking verbose/brief/off, budget, level"),
+    ("tools",       "Tool inventory  ·  /tools smoke"),
+    ("trust",       "Workspace trust  ·  /trust on|off"),
+    ("version",     "GemCode version"),
+]
+
+
+def install_readline_slash_completion() -> bool:
+  """
+  Enable Tab completion for slash commands in the plain REPL (``input("> ")``).
+
+  Returns False if readline is unavailable or stdin is not a TTY.
+  """
+  try:
+    import readline
+  except ImportError:
+    return False
+  if not hasattr(sys.stdin, "isatty") or not sys.stdin.isatty():
+    return False
+
+  # Treat ``/foo`` as one word so Tab completes after ``/``.
+  try:
+    delims = readline.get_completer_delims()
+    if "/" in delims:
+      readline.set_completer_delims(delims.replace("/", ""))
+  except Exception:
+    pass
+
+  ordered = [name for name, _ in SLASH_COMMANDS]
+  _matches: list[str] = []
+
+  def completer(text: str, state: int) -> str | None:
+    nonlocal _matches
+    if state == 0:
+      _matches = []
+      if not text.startswith("/"):
+        return None
+      # Only complete the first token (/command …); skip when typing args.
+      if " " in text[1:]:
+        return None
+      frag = text[1:].lower()
+      for n in ordered:
+        if not frag or n.startswith(frag) or frag in n:
+          _matches.append(f"/{n} ")
+      if not _matches:
+        return None
+    try:
+      return _matches[state]
+    except IndexError:
+      return None
+
+  readline.set_completer(completer)
+  # GNU readline: double-Tab lists matches. libedit (macOS) may ignore unknown "set" directives.
+  for spec in (
+      "set show-all-if-ambiguous on",
+      "set completion-ignore-case on",
+      "tab: complete",
+  ):
+    try:
+      readline.parse_and_bind(spec)
+    except Exception:
+      pass
+  return True
+
+
 def slash_help_lines() -> list[str]:
   return [
       "Slash commands:",
@@ -203,13 +320,18 @@ def slash_help_lines() -> list[str]:
       "  (CLI) gemcode login   Save or change API key (~/.gemcode/credentials.json)",
       "",
       "  Project setup:",
+      "  /trust                Show workspace trust status (file/shell tools)",
+      "  /trust on|off         Trust or revoke trust for this project root (~/.gemcode/trust.json)",
       "  /init                 Analyze project structure and generate GEMINI.md",
       "  /init force           Regenerate GEMINI.md even if it already exists",
       "  /cost                 Show token usage and estimated cost for this session",
       "  /notes                Show agent auto-notes (.gemcode/notes.md)",
       "  /notes clear          Delete all notes",
       "  /notes edit           Open notes in $EDITOR",
-      "  /create gemskill <name> [description]  Create a GemSkill scaffold under .gemcode/skills/",
+      "  /create gemskill <name> [description]  Create a new GemSkill (SKILL.md scaffold)",
+      "  /gemskill <name>        Load an existing GemSkill into this session (system prompt)",
+      "  /gemskill list|clear    List skills or unload all session-loaded skills",
+      "  /append gemskill <name> <request>  Ask the agent to edit that skill file",
       "  /style                List available output styles",
       "  /style <name>|off     Activate an output style for this session",
       "  /rules                Show loaded rule files (from .gemcode/rules/)",
@@ -237,6 +359,13 @@ def slash_help_lines() -> list[str]:
       "  /context              Show context pressure + last prompt tokens",
       "  /audit [N]            Tail of .gemcode/audit.log (default 40 lines)",
       "  /tools                List tool inventory for this config",
+      "  /tools smoke          Declaration compile check only (failures listed)",
+      "  /eval [llm]           Run tools_smoke (+ pytest if tests/ exist); optional LLM goldens",
+      "  /autotune init <tag>  Git branch autotune/<tag> for experiment tracking",
+      "  /autotune eval [llm]  Eval + append .gemcode/evals/autotune_ledger.jsonl",
+      "  /curated              Show GEMCODE_MEMORY.md / GEMCODE_USER.md snapshot",
+      "  /login                How to run gemcode login (API key outside REPL)",
+      "  /live-audio           How to run gemcode live-audio (mic → Gemini Live)",
       "  /doctor               Environment sanity check",
       "  /version              Print GemCode version hint",
       "  /exit                 Exit the REPL",
@@ -254,6 +383,7 @@ def slash_help_lines() -> list[str]:
       "  /computer url         Show current browser URL",
       "  /research             Show deep-research status",
       "  /research on|off      Enable/disable Google Search + URL Context tools",
+      "  /maps on|off          Enable/disable Maps grounding (runner rebuild)",
       "  /embeddings on|off    Enable/disable semantic file search (Embeddings API)",
       "  /caps                 View all capability flags",
       "  /caps <research|embeddings|all|reset>  Bulk capability control",

gemcode/repl_slash.py

@@ -28,10 +28,12 @@ from gemcode.repl_commands import (
   format_tools_lines,
   slash_help_lines,
 )
+from gemcode.curated_memory import load_snapshot as _curated_load_snapshot
 from gemcode.slash_commands import parse_slash_command
 from gemcode.skills import discover_skill_metas, expand_skill_text, list_supporting_files, load_skill
 from gemcode.output_styles import discover_output_styles, load_output_style
 from gemcode.rules import load_rules as _load_rules
+from gemcode.trust import is_trusted_root, trust_json_path, trust_root
 
 
 @dataclass
@@ -45,6 +47,12 @@ class ReplSlashResult:
   force_rebuild_runner: bool = False  # True when agent config changed (thinking, etc.)
 
 
+def _clear_session_loaded_skills(cfg: GemCodeConfig) -> None:
+  raw = getattr(cfg, "session_loaded_skill_names", None)
+  if isinstance(raw, list):
+    raw.clear()
+
+
 def _parse_tail_n(args: str, *, default: int = 40) -> int:
   parts = (args or "").strip().split()
   if not parts:
@@ -116,6 +124,61 @@ async def process_repl_slash(
     )
     return ReplSlashResult(model_prompt=prompt)
 
+  # ── /gemskill (load full skill into session system prompt) ────────────────
+  if name == "gemskill":
+    args_gs = (sc.args or "").strip()
+    if not args_gs or args_gs.lower() in ("help", "?"):
+      out("Usage:")
+      out("  /gemskill <name>   Load an existing GemSkill into this session (system prompt).")
+      out("  /gemskill list     List skills you can load")
+      out("  /gemskill clear    Unload all session-loaded skills")
+      out()
+      out("Create a new skill:  /create gemskill <name> [description]")
+      out("Edit an existing one: /append gemskill <name> <what to change>")
+      out()
+      return ReplSlashResult(skip_model_turn=True)
+    al = args_gs.lower()
+    if al in ("list", "ls", "show"):
+      metas_gs = discover_skill_metas(cfg.project_root)
+      if not metas_gs:
+        out("No GemSkills found.")
+        out("Create one: /create gemskill <name> [description]")
+        out()
+        return ReplSlashResult(skip_model_turn=True)
+      out("GemSkills (load with /gemskill <name>):")
+      for k in sorted(metas_gs.keys()):
+        m, _ = metas_gs[k]
+        inv = "manual-only" if m.disable_model_invocation else "auto-eligible"
+        out(f"  {m.name} ({inv}) — {m.description}")
+      out()
+      return ReplSlashResult(skip_model_turn=True)
+    if al == "clear":
+      _clear_session_loaded_skills(cfg)
+      cfg.session_skill_expand_session_id = session_id
+      out("Session-loaded GemSkills cleared.")
+      out("Runner will rebuild on the next turn.")
+      out()
+      return ReplSlashResult(skip_model_turn=True, force_rebuild_runner=True)
+    sk_part = args_gs.split()[0].strip().lower()
+    s_gs = load_skill(cfg.project_root, sk_part)
+    if s_gs is None:
+      out(f"Unknown skill: {sk_part}")
+      out("Tip: /gemskill list  ·  Create: /create gemskill <name>")
+      out()
+      return ReplSlashResult(skip_model_turn=True)
+    loaded = cfg.session_loaded_skill_names
+    if sk_part in loaded:
+      out(f"GemSkill `/{sk_part}` is already loaded for this session.")
+      out()
+      return ReplSlashResult(skip_model_turn=True)
+    loaded.append(sk_part)
+    cfg.session_skill_expand_session_id = session_id
+    out(f"Loaded GemSkill into session: /{sk_part}")
+    out("Full skill body is now in the system prompt until /gemskill clear or a new session.")
+    out("Runner will rebuild on the next turn.")
+    out()
+    return ReplSlashResult(skip_model_turn=True, force_rebuild_runner=True)
+
   # ── /batch (built-in GemSkill) ─────────────────────────────────────────────
   if name == "batch":
     goal = (sc.args or "").strip()
@@ -230,10 +293,42 @@ async def process_repl_slash(
 
     out(f"Created GemSkill: /{skill_name}")
     out(f"Path: {skill_md}")
-    out("Try: /skills   then   /" + skill_name + " <args>")
+    out("Try: /gemskill " + skill_name + "   or   /" + skill_name + " <args> for a one-shot turn")
     out()
     return ReplSlashResult(skip_model_turn=True)
 
+  # ── /append gemskill (iterate existing SKILL.md) ───────────────────────────
+  if name == "append":
+    raw_ap = (sc.args or "").strip()
+    parts_ap = raw_ap.split(None, 2)
+    if len(parts_ap) < 3 or parts_ap[0].lower() != "gemskill":
+      out("Usage: /append gemskill <name> <what to add or change>")
+      out("Example: /append gemskill review-code Add a checklist for API security")
+      out()
+      return ReplSlashResult(skip_model_turn=True)
+    sk_ap = parts_ap[1].strip().lower()
+    instruction_ap = parts_ap[2].strip()
+    s_ap = load_skill(cfg.project_root, sk_ap)
+    if s_ap is None:
+      out(f"Unknown skill: {sk_ap}")
+      out("Tip: /gemskill list")
+      out()
+      return ReplSlashResult(skip_model_turn=True)
+    files_ap = list_supporting_files(s_ap)
+    prompt_ap = (
+        f"The user wants to **iterate** on an existing GemSkill ({sk_ap!r}).\n\n"
+        f"## Skill file (primary edit target)\n`{s_ap.skill_md}`\n\n"
+        f"## User request\n{instruction_ap}\n\n"
+        "## Instructions\n"
+        "1. Read the full SKILL.md (and supporting files only if needed).\n"
+        "2. Apply the user's request: clarify steps, add sections, improve examples, fix mistakes.\n"
+        "3. Preserve valid YAML frontmatter (`name`, `description`, etc.) unless the user asked to rename.\n"
+        "4. Save changes with `search_replace` or `write_file`.\n"
+        "5. Summarize what you changed.\n\n"
+        + (f"## Supporting files (optional)\n{', '.join(files_ap)}\n\n" if files_ap else "")
+    )
+    return ReplSlashResult(model_prompt=prompt_ap)
+
   # ── /style ────────────────────────────────────────────────────────────────
   if name == "style":
     args = (sc.args or "").strip()
@@ -293,6 +388,44 @@ async def process_repl_slash(
     out()
     return ReplSlashResult(skip_model_turn=True)
 
+  # ── /trust (workspace permission for tools) ─────────────────────────────────
+  if name == "trust":
+    args_s = (sc.args or "").strip().lower()
+    root = cfg.project_root.resolve()
+    tpath = trust_json_path()
+
+    if args_s in ("", "status", "show"):
+      if is_trusted_root(root):
+        out(f"Workspace is trusted:\n  {root}")
+      else:
+        out(f"Workspace is NOT trusted:\n  {root}")
+        out("File, shell, and git tools require trust. Use: /trust on")
+      out(f"Trust database: {tpath}")
+      out()
+      return ReplSlashResult(skip_model_turn=True)
+
+    if args_s in ("on", "yes", "y", "1", "true", "enable"):
+      trust_root(root, trusted=True)
+      out(f"Trusted:\n  {root}")
+      out(f"Saved to {tpath}")
+      out()
+      return ReplSlashResult(skip_model_turn=True)
+
+    if args_s in ("off", "no", "n", "0", "false", "disable", "revoke"):
+      trust_root(root, trusted=False)
+      out(f"Removed trust for:\n  {root}")
+      out("Tools will refuse until you run /trust on (or approve on next CLI start).")
+      out()
+      return ReplSlashResult(skip_model_turn=True)
+
+    out("Usage:")
+    out("  /trust           Show whether this project root is trusted")
+    out("  /trust on        Trust this workspace (required for file/shell/git tools)")
+    out("  /trust off       Stop trusting this workspace")
+    out(f"  (stored under {tpath.parent}/)")
+    out()
+    return ReplSlashResult(skip_model_turn=True)
+
   # ── /add-dir (safe multi-root access) ──────────────────────────────────────
   if name in ("add-dir", "add_dir", "adddir"):
     import os
@@ -539,6 +672,141 @@ async def process_repl_slash(
     out()
     return ReplSlashResult(skip_model_turn=True)
 
+  # ── /eval ─────────────────────────────────────────────────────────────────
+  if name == "eval":
+    raw_args = (sc.args or "").strip().lower()
+    include_llm = "llm" in raw_args or "--llm" in raw_args
+    from gemcode.evals.harness import run_eval_suite, write_eval_record
+
+    try:
+      res = run_eval_suite(
+        project_root=cfg.project_root,
+        include_llm=include_llm,
+        model=None,
+        session_cfg=cfg,
+        extra_tools=extra_tools,
+      )
+    except Exception as e:
+      out(f"eval failed: {type(e).__name__}: {e}")
+      out()
+      return ReplSlashResult(skip_model_turn=True)
+    try:
+      rec_path = write_eval_record(cfg.project_root, res)
+      out(f"eval: ok={res.get('ok')}  score={float(res.get('score', 0)):.2f}  elapsed_s={float(res.get('elapsed_s', 0)):.1f}  → {rec_path}")
+    except OSError:
+      out(f"eval: ok={res.get('ok')}  score={float(res.get('score', 0)):.2f}  elapsed_s={float(res.get('elapsed_s', 0)):.1f}")
+    for row in res.get("results") or []:
+      nm = row.get("name", "?")
+      ok = row.get("ok", False)
+      out(f"  {nm}: {'ok' if ok else 'FAIL'}")
+      if not ok and row.get("details"):
+        det = str(row["details"]).strip()
+        if det:
+          snippet = det[-600:] if len(det) > 600 else det
+          out(f"    {snippet}")
+    out()
+    return ReplSlashResult(skip_model_turn=True)
+
+  # ── /autotune ───────────────────────────────────────────────────────────────
+  if name == "autotune":
+    parts = (sc.args or "").strip().split()
+    if not parts:
+      out("Usage:")
+      out("  /autotune init <tag>   Create git branch autotune/<tag> (requires git repo)")
+      out("  /autotune eval [llm]   Run eval suite and append .gemcode/evals/autotune_ledger.jsonl")
+      out()
+      return ReplSlashResult(skip_model_turn=True)
+    sub = parts[0].lower()
+    if sub == "init":
+      if len(parts) < 2:
+        out("Usage: /autotune init <tag>")
+        out()
+        return ReplSlashResult(skip_model_turn=True)
+      tag = parts[1].strip()
+      from gemcode.autotune import init_autotune
+
+      r = init_autotune(project_root=cfg.project_root, tag=tag)
+      if r.get("error"):
+        out(f"autotune init: {r.get('error')}")
+        if r.get("output"):
+          out(str(r["output"])[-800:])
+      else:
+        out(f"autotune init: {r.get('status')}  branch={r.get('branch')}")
+      out()
+      return ReplSlashResult(skip_model_turn=True)
+    if sub == "eval":
+      include_llm = any(p.lower() in ("llm", "--llm") for p in parts[1:])
+      from gemcode.autotune import run_autotune_eval
+
+      try:
+        r = run_autotune_eval(
+          project_root=cfg.project_root,
+          include_llm=include_llm,
+          model=None,
+          session_cfg=cfg,
+          extra_tools=extra_tools,
+        )
+      except Exception as e:
+        out(f"autotune eval failed: {type(e).__name__}: {e}")
+        out()
+        return ReplSlashResult(skip_model_turn=True)
+      out(f"autotune eval: ok={r.get('ok')}  score={float(r.get('score', 0)):.2f}")
+      if r.get("record_path"):
+        out(f"  record: {r['record_path']}")
+      if r.get("ledger_path"):
+        out(f"  ledger: {r['ledger_path']}")
+      out()
+      return ReplSlashResult(skip_model_turn=True)
+    out(f"Unknown /autotune subcommand: {sub}")
+    out("Usage: /autotune init <tag>  ·  /autotune eval [llm]")
+    out()
+    return ReplSlashResult(skip_model_turn=True)
+
+  # ── /curated (curated memory files) ────────────────────────────────────────
+  if name in ("curated", "memory-files", "memoryfiles"):
+    snap = _curated_load_snapshot(cfg.project_root, max_chars=8000)
+    out("Curated memory (injected when memory is on):")
+    out(f"  project: {snap.get('memory_path')}")
+    out(f"  user:    {snap.get('user_path')}")
+    out(f"  loaded:  {snap.get('chars', 0)} chars  exists={snap.get('exists')}")
+    out()
+    txt = (snap.get("text") or "").strip()
+    if txt:
+      out("--- snapshot ---")
+      out(txt)
+      out("--- end ---")
+    else:
+      out("(empty — create .gemcode/GEMCODE_MEMORY.md and GEMCODE_USER.md)")
+    out()
+    return ReplSlashResult(skip_model_turn=True)
+
+  # ── /login ─────────────────────────────────────────────────────────────────
+  if name == "login":
+    from gemcode.credentials import credentials_path
+
+    out("API keys are not stored inside the REPL. Use a separate terminal:")
+    out()
+    out("  gemcode login")
+    out()
+    out("Creates or updates your key at:")
+    out(f"  {credentials_path()}")
+    out()
+    out("Get a key: https://aistudio.google.com/app/apikey")
+    out()
+    return ReplSlashResult(skip_model_turn=True)
+
+  # ── /live-audio ────────────────────────────────────────────────────────────
+  if name in ("live-audio", "liveaudio"):
+    out("Live audio (microphone → Gemini Live) runs as a dedicated CLI, not inside this REPL.")
+    out()
+    out("Example:")
+    out(f"  gemcode live-audio -C {cfg.project_root}")
+    out()
+    out("Flags: --seconds N  --rate 24000  --language en-US  --model <id>")
+    out("       --yes  --deep-research  --embeddings  --session <uuid>")
+    out()
+    return ReplSlashResult(skip_model_turn=True)
+
   if name in ("model", "models"):
     args = (sc.args or "").strip()
     if not args:
@@ -772,6 +1040,22 @@ async def process_repl_slash(
     return ReplSlashResult(skip_model_turn=True)
 
   if name == "tools":
+    args_t = (sc.args or "").strip().lower()
+    if args_t in ("smoke", "decl", "declarations"):
+      from gemcode.tools_inspector import inspect_tools, smoke_tools
+
+      inspections = inspect_tools(cfg, extra_tools=extra_tools)
+      bad = smoke_tools(inspections)
+      if not bad:
+        out(f"tools smoke: OK ({len(inspections)} tools, declarations compile)")
+      else:
+        out(f"tools smoke: {len(bad)} failure(s) of {len(inspections)} tools")
+        for i in bad[:60]:
+          out(f"  {i.name}: {i.declaration_error}")
+        if len(bad) > 60:
+          out(f"  … ({len(bad) - 60} more)")
+      out()
+      return ReplSlashResult(skip_model_turn=True)
     out("\n".join(format_tools_lines(cfg, extra_tools=extra_tools)))
     out()
     return ReplSlashResult(skip_model_turn=True)
@@ -787,6 +1071,8 @@ async def process_repl_slash(
     out(f"model_mode:     {cfg.model_mode}")
     out(f"session_id:     {session_id}")
     out(f"project_root:   {cfg.project_root}")
+    _lg = getattr(cfg, "session_loaded_skill_names", None) or []
+    out(f"loaded_skills:  {', '.join(_lg) if _lg else '(none)'}  (/gemskill)")
     out()
     out("Capabilities:")
     out(f"  deep_research:  {'on  ✓' if cfg.enable_deep_research else 'off'}")
@@ -891,10 +1177,15 @@ async def process_repl_slash(
 
     # /clear or /session new — start fresh session
     if name == "clear" or args_lower in ("new", "reset"):
+      _clear_session_loaded_skills(cfg)
       new_id = str(uuid.uuid4())
       out(f"new session_id: {new_id}")
       out()
-      return ReplSlashResult(skip_model_turn=True, new_session_id=new_id)
+      return ReplSlashResult(
+          skip_model_turn=True,
+          new_session_id=new_id,
+          force_rebuild_runner=True,
+      )
 
     # /session list — show recent sessions
     if args_lower in ("list", "ls", "history"):
@@ -940,9 +1231,14 @@ async def process_repl_slash(
         out(f"Already in session {found[:8]}.")
         out()
         return ReplSlashResult(skip_model_turn=True)
+      _clear_session_loaded_skills(cfg)
       out(f"Resuming session {found[:8]}…")
       out()
-      return ReplSlashResult(skip_model_turn=True, new_session_id=found)
+      return ReplSlashResult(
+          skip_model_turn=True,
+          new_session_id=found,
+          force_rebuild_runner=True,
+      )
 
     # Default: show current session info
     from gemcode.session_store import get_session_name, touch_session
@@ -1327,6 +1623,33 @@ async def process_repl_slash(
     out()
     return ReplSlashResult(skip_model_turn=True)
 
+  # ── /maps (Maps grounding, deep-research stack) ────────────────────────────
+  if name in ("maps", "map"):
+    args_s = (sc.args or "").strip().lower()
+    if not args_s or args_s in ("status", "show"):
+      status = "on  ✓" if cfg.enable_maps_grounding else "off"
+      out(f"maps_grounding: {status}")
+      out()
+      out("Commands: /maps on  ·  /maps off")
+      out("When on: Maps-backed grounding is available alongside deep-research tools (if enabled).")
+      out()
+      return ReplSlashResult(skip_model_turn=True)
+    if args_s == "on":
+      cfg.enable_maps_grounding = True
+      out("maps_grounding: on")
+      out("  Runner will rebuild on next turn.")
+      out()
+      return ReplSlashResult(skip_model_turn=True, force_rebuild_runner=True)
+    if args_s == "off":
+      cfg.enable_maps_grounding = False
+      out("maps_grounding: off")
+      out()
+      return ReplSlashResult(skip_model_turn=True, force_rebuild_runner=True)
+    out(f"Unknown /maps subcommand: '{args_s}'")
+    out("Usage: /maps [on|off]")
+    out()
+    return ReplSlashResult(skip_model_turn=True)
+
   # ── /mode ─────────────────────────────────────────────────────────────────
   if name == "mode":
     args_s = (sc.args or "").strip().lower()

gemcode/trust.py

@@ -10,6 +10,11 @@ def _trust_file_path() -> Path:
   return base / "trust.json"
 
 
+def trust_json_path() -> Path:
+  """Path to the trust database (respects GEMCODE_HOME)."""
+  return _trust_file_path()
+
+
 def load_trusted_roots() -> set[str]:
   """
   Returns a set of resolved absolute paths (as strings) that are trusted.

gemcode/tui/input_handler.py

@@ -36,48 +36,7 @@ try:
 except ImportError:
     pass
 
-# ---------------------------------------------------------------------------
-# Slash command registry
-# (name without /, description shown in the autocomplete popup)
-# ---------------------------------------------------------------------------
-SLASH_COMMANDS: list[tuple[str, str]] = [
-    ("help",        "List all available commands"),
-    ("init",        "Analyze project and generate GEMINI.md project instructions"),
-    ("cost",        "Show session token usage and estimated USD cost breakdown"),
-    ("notes",       "View agent auto-generated project notes (.gemcode/notes.md)"),
-    ("diff",        "Show git diff (or checkpoint diff fallback)"),
-    ("rewind",      "Restore files to a previous checkpoint  ·  alias: /checkpoint"),
-    ("add-dir",     "Add extra directory for read/search access  ·  /add-dir list"),
-    ("batch",       "Parallel large-change orchestrator (built-in GemSkill)"),
-    ("review",      "Parallel code review: security + style + correctness simultaneously"),
-    ("compact",     "Compact conversation history to free context window"),
-    ("clear",       "Start a fresh session (clears history)  ·  alias: /session new"),
-    ("model",       "View or switch model  ·  /model use <id>  ·  /model list"),
-    ("mode",        "Set model mode  ·  /mode fast|balanced|quality|auto"),
-    ("thinking",    "Thinking config  ·  /thinking verbose  ·  /thinking brief  ·  /thinking budget <N>"),
-    ("status",      "Show full session status: model, capabilities, thinking, limits"),
-    ("context",     "Show context window usage and token counts"),
-    ("compact",     "Summarise conversation history to reclaim context space"),
-    ("research",    "Toggle Google Search + URL Context  ·  /research on|off"),
-    ("embeddings",  "Toggle semantic file search via Embeddings API  ·  /embeddings on|off"),
-    ("computer",    "Browser automation (Playwright Chromium)  ·  /computer on|off|url"),
-    ("caps",        "View/toggle all capabilities  ·  /caps  ·  /caps all  ·  /caps reset"),
-    ("memory",      "Toggle persistent memory  ·  /memory on|off"),
-    ("budget",      "Set per-turn token budget  ·  /budget <N>  ·  /budget off"),
-    ("limits",      "Show/set execution limits (max_llm_calls, context, etc.)"),
-    ("kaira",       "Background parallel job scheduler — how to run gemcode kaira"),
-    ("code",        "Toggle sandboxed Python code executor (ADK BuiltInCodeExecutor)"),
-    ("plan",        "Toggle plan mode — agent writes explicit plan before executing tools"),
-    ("tools",       "List all tools and their permission categories"),
-    ("config",      "Show full active configuration (all fields)"),
-    ("permissions", "Show current permission mode (default / strict / yes)"),
-    ("session",     "Show current session ID  ·  /session new to reset"),
-    ("audit",       "Show recent audit log  ·  /audit [N lines]"),
-    ("doctor",      "Run diagnostics and validate the environment"),
-    ("hooks",       "Show post-turn hook configuration"),
-    ("version",     "Show installed GemCode version"),
-    ("exit",        "Exit GemCode"),
-]
+from gemcode.repl_commands import SLASH_COMMANDS
 
 
 # ---------------------------------------------------------------------------
@@ -136,6 +95,13 @@ class GemCodeInputHandler:
 
         if _PT_AVAILABLE and sys.stdin.isatty() and sys.stdout.isatty():
             self._build_session()
+        elif sys.stdin.isatty():
+            try:
+                from gemcode.repl_commands import install_readline_slash_completion
+
+                install_readline_slash_completion()
+            except Exception:
+                pass
 
     def _build_session(self) -> None:
         style = Style.from_dict(

gemcode/tui/scrollback.py

@@ -530,6 +530,7 @@ async def run_gemcode_scrollback_tui(
     old_model = getattr(cfg, "model", "")
     old_model_overridden = bool(getattr(cfg, "model_overridden", False))
 
+    cfg.session_skill_expand_session_id = current_session_id
     slash = await process_repl_slash(
         cfg=cfg,
         runner=runner,

{gemcode-0.3.77.dist-info → gemcode-0.3.78.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemcode
-Version: 0.3.77
+Version: 0.3.78
 Summary: Local-first coding agent on Google Gemini + ADK
 Author: GemCode Contributors
 License:                                  Apache License
@@ -197,32 +197,82 @@ This document is the **authoritative reference** for CLI behavior, configuration
 
 ## Table of contents
 
-1. [Architecture](#architecture)
-2. [Requirements and install](#requirements-and-install)
-3. [First run](#first-run)
-4. [CLI commands](#cli-commands)
-5. [Main CLI flags](#main-cli-flags)
-6. [The `.gemcode/` directory](#the-gemcode-directory)
-7. [Project context: `GEMINI.md`](#project-context-geminimd)
-8. [Function tools (catalog)](#function-tools-catalog)
-9. [REPL: slash commands](#repl-slash-commands)
-10. [GemSkills](#gemskills)
-11. [Output styles and rules](#output-styles-and-rules)
-12. [Checkpoints, diff, and rewind](#checkpoints-diff-and-rewind)
-13. [Multi-root workspaces (`/add-dir`)](#multi-root-workspaces-add-dir)
-14. [Model routing and thinking](#model-routing-and-thinking)
-15. [Capabilities](#capabilities)
-16. [Permissions and interactive approval](#permissions-and-interactive-approval)
-17. [Hooks](#hooks)
-18. [Token budget, context, and compaction](#token-budget-context-and-compaction)
-19. [MCP](#mcp)
-20. [IDE bridge: `gemcode ide --stdio`](#ide-bridge-gemcode-ide-stdio)
-21. [Eval harness and autotune](#eval-harness-and-autotune)
-22. [Kaira scheduler](#kaira-scheduler)
-23. [Live audio](#live-audio)
-24. [Related components](#related-components)
-25. [Environment variables](#environment-variables)
-26. [Development and release](#development-and-release)
+1. [What GemCode is (detailed)](#what-gemcode-is-detailed)
+2. [Architecture](#architecture)
+3. [Requirements and install](#requirements-and-install)
+4. [First run](#first-run)
+5. [CLI commands](#cli-commands)
+6. [Main CLI flags](#main-cli-flags)
+7. [The `.gemcode/` directory](#the-gemcode-directory)
+8. [Project context: `GEMINI.md`](#project-context-geminimd)
+9. [Function tools (catalog)](#function-tools-catalog)
+10. [REPL: slash commands](#repl-slash-commands)
+11. [GemSkills](#gemskills)
+12. [Curated memory](#curated-memory)
+13. [Workspace trust](#workspace-trust)
+14. [Output styles and rules](#output-styles-and-rules)
+15. [Checkpoints, diff, and rewind](#checkpoints-diff-and-rewind)
+16. [Multi-root workspaces (`/add-dir`)](#multi-root-workspaces-add-dir)
+17. [Model routing and thinking](#model-routing-and-thinking)
+18. [Capabilities](#capabilities)
+19. [Permissions and interactive approval](#permissions-and-interactive-approval)
+20. [Hooks](#hooks)
+21. [Token budget, context, and compaction](#token-budget-context-and-compaction)
+22. [MCP](#mcp)
+23. [IDE bridge: `gemcode ide --stdio`](#ide-bridge-gemcode-ide-stdio)
+24. [Eval harness and autotune](#eval-harness-and-autotune)
+25. [Kaira scheduler](#kaira-scheduler)
+26. [Live audio](#live-audio)
+27. [Related components](#related-components)
+28. [Environment variables](#environment-variables)
+29. [Development and release](#development-and-release)
+
+---
+
+## What GemCode is (detailed)
+
+**GemCode** is a single Python package that exposes a **`gemcode`** CLI. Every invocation is anchored to a **project root** (`-C`, default current directory). From there it:
+
+- Builds a **GemCodeConfig** (model, capabilities, permissions, limits, paths).
+- Optionally loads **MCP** toolsets from `.gemcode/mcp.json`.
+- Constructs an ADK **Runner** with a root **LlmAgent** whose **system instruction** aggregates: global behavior, `GEMINI.md`, capability sections, tool manifest, optional **output style** and **rules**, the **skills manifest** (metadata only), and any **session-loaded GemSkills** (full bodies after `/gemskill`).
+- Persists conversation state in **SQLite** (`.gemcode/sessions.sqlite`) keyed by **`--session`** / REPL session id.
+
+### Modes of use
+
+| Mode | How | Best for |
+|------|-----|----------|
+| **One-shot CLI** | `gemcode -C repo "prompt"` | Scripts, CI-style runs, quick questions. |
+| **REPL** | `gemcode -C repo` (TTY, no prompt arg) | Long sessions, slash commands, exploration. |
+| **TUI** | Same as REPL with `GEMCODE_TUI=1` (default when supported) | Scrollback, styled output, slash **completion menu**. |
+| **IDE** | VS Code extension → `gemcode ide --stdio` | Editor-native Chat, diff apply, proposals. |
+| **Kaira** | `gemcode kaira` | Background queue of independent agent jobs. |
+| **Live audio** | `gemcode live-audio` | Voice → Gemini Live (separate from file-editing REPL). |
+
+### “Memory” in GemCode (three different things)
+
+| Mechanism | Where | Purpose |
+|-----------|--------|---------|
+| **Session history** | `sessions.sqlite` | Full turn-by-turn chat for a session id. |
+| **Curated memory** | `GEMCODE_MEMORY.md`, `GEMCODE_USER.md` (under `.gemcode/`) | Small, **human-approved** facts injected when memory features are on; distinct from noisy auto-memory. |
+| **Embedding memory** | `memories.jsonl` + ADK hooks (when enabled) | Retrieval-oriented storage when **`GEMCODE_ENABLE_MEMORY`** (and related) are on. |
+
+Use **`/curated`** in the REPL to preview the curated snapshot; tools such as **`read_curated_memory`** / **`remember_fact`** operate on that layer.
+
+### GemSkills at a glance (four ways)
+
+| Mechanism | Effect |
+|-----------|--------|
+| **`/create gemskill <name> [description]`** | Creates **`.gemcode/skills/<name>/SKILL.md`** scaffold (new skill on disk). |
+| **`/gemskill <name>`** | **Pins** the skill’s **full body** into the **system instruction** for the **current session** (until `/gemskill clear`, new session, or resume). Rebuilds the runner. |
+| **`/append gemskill <name> <request>`** | One model turn instructed to **edit** that skill file according to `<request>`. |
+| **`/skill <name>`**, **`/<name>`**, or tools **`load_skill`** | **One-shot** turn: inject expanded skill into the **user message** for that turn only (does not pin to system prompt). |
+
+The built-in **`batch`** skill is manual-only (`disable_model_invocation`); use **`/batch <goal>`** to run it.
+
+### Slash completion
+
+The REPL and TUI use a **canonical** command list for Tab completion (`repl_commands.SLASH_COMMANDS`). Some spellings (e.g. `/quit`, `/logs`, `/embed`) still work in **`process_repl_slash`** but may not appear as separate menu rows—see descriptions in **`/help`**.
 
 ---
 
@@ -311,6 +361,7 @@ State is **project-local** (unless noted).
 | Path / artifact | Purpose |
 |-----------------|---------|
 | `sessions.sqlite` | ADK session service: conversation history for `--session` ids. |
+| `GEMCODE_MEMORY.md`, `GEMCODE_USER.md` | **Curated memory** (see [Curated memory](#curated-memory)). |
 | `audit.log` | JSONL audit: tool usage, model usage, terminal reasons, optional tool-use summaries. |
 | `tool-results/` | Offloaded large tool outputs; references like `tool_result:<sha256>`. |
 | `artifacts/` | File artifacts (ADK `FileArtifactService`). |
@@ -421,10 +472,15 @@ In interactive mode, lines starting with `/` are **slash commands** (see `repl_c
 
 | Command | Purpose |
 |---------|---------|
+| `/trust`, `/trust on`, `/trust off` | Show, grant, or revoke **workspace trust** for the project root (stored in `~/.gemcode/trust.json`; required for file/shell/git tools). |
 | `/init` \| `/init force` | Analyze the repo and generate or overwrite `GEMINI.md`. |
 | `/cost` | Token usage and estimated cost for the session. |
 | `/notes`, `/notes clear`, `/notes edit` | View, clear, or edit `.gemcode/notes.md`. |
-| `/create gemskill <name> [description]` | Scaffold `.gemcode/skills/<name>/SKILL.md`. |
+| `/create gemskill <name> [description]` | **Create** a new GemSkill (scaffold `SKILL.md`). |
+| `/gemskill <name>` | **Load** an existing skill into the **session system prompt** (until `/gemskill clear` or new session). |
+| `/gemskill list` \| `/gemskill clear` | List skills or unload all session-loaded skills. |
+| `/append gemskill <name> <request>` | **Iterate** the skill file: model edits `SKILL.md` per your request. |
+| `/curated` | Show **curated memory** snapshot (`.gemcode/GEMCODE_MEMORY.md`, `GEMCODE_USER.md`). |
 | `/style`, `/style <name>\|off` | List or activate **output styles** (`.gemcode/output-styles/*.md`). |
 | `/rules` | Show **rule** files from `.gemcode/rules/` (with path gating). |
 | `/diff`, `/diff last`, `/diff cp_…` | Git diff, or **checkpoint → workspace** diff. |
@@ -437,7 +493,7 @@ In interactive mode, lines starting with `/` are **slash commands** (see `repl_c
 | Command | Purpose |
 |---------|---------|
 | `/help` | Short help. |
-| `/status` | Model, capabilities, thinking, limits, risk/context telemetry. |
+| `/status` | Model, capabilities, thinking, limits, risk/context telemetry; **`loaded_skills`** (session-pinned GemSkills from `/gemskill`). |
 | `/config` | Dump active config fields. |
 | `/session`, `/session list`, `/session name`, `/session resume`, `/session new` | Session management; `/clear` aliases `/session new`. |
 | `/compact`, `/compact <focus>` | Force context compaction / summarization. |
@@ -445,6 +501,12 @@ In interactive mode, lines starting with `/` are **slash commands** (see `repl_c
 | `/context` | Context pressure and token breakdown (includes styles, rules, skills manifest, touched paths). |
 | `/audit [N]` | Tail of `audit.log`. |
 | `/tools` | Tool inventory for current config. |
+| `/tools smoke` | Declaration compile check only (lists failures). |
+| `/eval`, `/eval llm` | **Eval harness**: tool smoke + `pytest` if a `tests/` tree exists; optional LLM golden prompts (costs tokens). Writes `.gemcode/evals/last_eval.json`. |
+| `/autotune init <tag>` | Create git branch `autotune/<tag>` (requires a git repo). |
+| `/autotune eval`, `… llm` | Run eval and append `.gemcode/evals/autotune_ledger.jsonl`. |
+| `/login` | How to run **`gemcode login`** (API key is set outside the REPL). |
+| `/live-audio` | How to run **`gemcode live-audio`** (mic → Gemini Live). |
 | `/doctor` | Environment sanity check. |
 | `/version` | Version string. |
 | `/exit` | Leave the REPL. |
@@ -462,6 +524,7 @@ In interactive mode, lines starting with `/` are **slash commands** (see `repl_c
 |---------|---------|
 | `/computer`, `/computer on\|off`, `/computer url` | Browser automation (Playwright). |
 | `/research`, `/research on\|off` | Deep research tools. |
+| `/maps`, `/maps on\|off` | Maps **grounding** toggle (runner rebuild). |
 | `/embeddings on\|off` | Semantic search tool. |
 | `/caps`, `/caps …` | View or bulk-toggle capabilities. |
 | `/memory`, `/memory on\|off` | Persistent memory. |
@@ -496,7 +559,33 @@ The TUI (when `GEMCODE_TUI=1` and terminal supports it) provides **slash complet
 - **Discovery:** Only **metadata** (name + description) is preloaded into context for token efficiency. Full body loads **on demand** via `/skill <name>`, `/<name>`, or tools `load_skill` / `list_skills`.
 - **Built-in:** **`batch`** — parallel large-change workflow (map → units → `run_subtask` → verify). Exposed as `/batch <goal>`; not auto-invoked by the model (`disable_model_invocation`).
 
-Use **`/create gemskill <name>`** to scaffold a new skill directory.
+- **`/create gemskill <name>`** — create a new skill directory.
+- **`/gemskill <name>`** — pin the full skill body into the system prompt for this session.
+- **`/append gemskill <name> <text>`** — one-shot turn for the model to revise that skill on disk.
+
+---
+
+## Curated memory
+
+**Curated memory** is a small, **intentional** text layer separate from raw session logs or embedding retrieval:
+
+- **Project facts:** `.gemcode/GEMCODE_MEMORY.md` (conventions, commands, architecture notes the team wants the agent to see).
+- **User preferences (per project):** `.gemcode/GEMCODE_USER.md`.
+
+Legacy filenames **`.gemcode/MEMORY.md`** and **`.gemcode/USER.md`** are still read if the new names are absent.
+
+Content is **sanitized** before append (length and sensitivity heuristics). The REPL command **`/curated`** prints a bounded snapshot of what would be injected. When the **memory** capability is enabled, curated material can be combined with broader memory tools—see **`remember_fact`**, **`read_curated_memory`** in the [function tools](#function-tools-catalog) table.
+
+---
+
+## Workspace trust
+
+File, shell, and related tools require the **project root** to be **trusted**. Trust is stored in **`~/.gemcode/trust.json`** (path configurable via **`GEMCODE_HOME`**), not inside the repo.
+
+- **`/trust`** — show whether the current root is trusted.
+- **`/trust on`** / **`/trust off`** — grant or revoke trust for **`cfg.project_root`**.
+
+Without trust, mutating and shell tools remain blocked even if **`--yes`** is set—this reduces accidental execution when the cwd is wrong (e.g. home directory).
 
 ---
 

{gemcode-0.3.77.dist-info → gemcode-0.3.78.dist-info}/RECORD

@@ -1,15 +1,15 @@
 gemcode/__init__.py,sha256=l0DCRYqK7KM7Fb7u49fqh-5_SlpeIL7r3LjMeJWMgSg,112
 gemcode/__main__.py,sha256=EX2s1hxq2Yvli_-tnBN3w5Qv4bOjsBBbjyISF0pDIQw,37
-gemcode/agent.py,sha256=r20SL_FNI-45rK3DjlecoqOR4MqEH69UpDfRF0trSzc,55480
+gemcode/agent.py,sha256=_v00pQSOzAI9nyaaKC1wn-aTalD4SV52KDzwlyIHJAo,56867
 gemcode/audit.py,sha256=bh9uhXaeh8wqxqoZtz3ZAowd8Ndk1ss-mw9993Vlrgo,469
 gemcode/autocompact.py,sha256=OE3QbGx2gWN2WVXy28Sd0xyfAJgVR1x6ml9HrX2CB7I,6719
-gemcode/autotune.py,sha256=3Oz3HLjqgrMyCivYa0kOLZWJ3iRV3oAFZYbMKOyZZ70,2479
+gemcode/autotune.py,sha256=zcTGDKC8LSnw0fHuoOcnnh1rz0by8K6MTUKl0_GhT9s,2704
 gemcode/callbacks.py,sha256=QR98bz-FeK2kp9N9JdzaeHRD2Ga2_rgz0XAPiYFafU0,31038
 gemcode/capability_routing.py,sha256=ZScRb2Bn41ZJUEmw_QaYYDVUPaNnbGBbK216tm5G4mI,3456
 gemcode/checkpoints.py,sha256=ptz2YW7P56mkqOrAf7-MXA0_Op3y4fgAg5ly_etuKvw,3936
-gemcode/cli.py,sha256=DowN0qGnjtl5AUOB5h65w7kGLkxWH2CRHly_cozUn84,27889
+gemcode/cli.py,sha256=2R5pvpx3T8sUnfgbBRmkFjv5-uxCPeo_HuXMsaz23s8,28429
 gemcode/compaction.py,sha256=9YtA_qa23_8dHWVHx7AJwUduuI7jJQtq-m6sT8jgPWI,1186
-gemcode/config.py,sha256=Xqox35fLqGaJtRiXEM_v7INTSg4sGe-Ym9JwOwyJVBY,17688
+gemcode/config.py,sha256=OTJrLFIX-sr6kMWVI4l8rM2kJqkt3X2NcNFBEg6Nfdg,18042
 gemcode/context_budget.py,sha256=nctVwzpUg6kyBL0FHM7xcrvVvZpX9qj7cZK4IczfKAg,10534
 gemcode/context_warning.py,sha256=YwkkNx6AM2ugOckg8QhRWYcU6D3UJXUOHiBwjKQT2rs,4199
 gemcode/credentials.py,sha256=o1gQ4oQXAjjA1IANXgCalM3WjTkfVkbkXsf-lNVQ55I,1300
@@ -39,8 +39,8 @@ gemcode/policy_profile.py,sha256=kcaKJQwLxAo3RjqfJJHl_G7B5GgTYKco0z3k5QcXsVY,386
 gemcode/pricing.py,sha256=lftp0SwyDqOzHqC2-6XzgZZhjif5PLdCe1Q3wY-p6kQ,3558
 gemcode/prompt_suggestions.py,sha256=RNEclxtoorRqu-wUlzuyUJ7OLFVOOryGOZBpbaCducI,2544
 gemcode/refine.py,sha256=BijEZ4Z32wGa9aK_WottyAhZF-j0xEqRg5UpjedNv2A,7653
-gemcode/repl_commands.py,sha256=wbrsn1aPW0bF2XVDqwiPqDZBW1qFCuQONASOUu0MKj0,12169
-gemcode/repl_slash.py,sha256=_I-kvZxi8j3ZCXPBI9cmJZJV0yLiz_-zDgoLKpBrTA8,69803
+gemcode/repl_commands.py,sha256=iGF68JdJiwryoZ69EvLSNAg7BN-ivopctJqNWe4UjWk,18467
+gemcode/repl_slash.py,sha256=zRBFJYnaNfO3yAfHQ5S9X-OyiZSWDePoR62OV5LbG5M,83743
 gemcode/review_agent.py,sha256=4t7_5-aE60b4-EheJ_eSB_H2eQYf9GppKoui6jw0TME,5264
 gemcode/rules.py,sha256=Itg02VpifOo6jqGj5xwna_ahaPPb0OVtaeR2cNI0pLE,3018
 gemcode/session_runtime.py,sha256=MQr34s6dw4bmk_VPSgBvkJTMwUBZQhvWDXl_iC5Pp6s,20867
@@ -52,13 +52,13 @@ gemcode/tool_prompt_manifest.py,sha256=BbM88yj6hN5CTDBzyHa7DZ1S6gpzIZQe9G7dFqkMm
 gemcode/tool_registry.py,sha256=DqHshoOG_8U5Ijey407DFxp3xYq3bVBLwUVxFgGgELs,1799
 gemcode/tool_result_store.py,sha256=50ufSP03F1D8mWFX7HFimTVh-fMWpshOtw4AP-qf-cU,6351
 gemcode/tools_inspector.py,sha256=ZAuD1oVIsZvyD_vrzaWBws2ezpFT6cIsU_w4yc_1PPA,4086
-gemcode/trust.py,sha256=fxe57Xg6aL_KU24bQDUtD-rXjsNpaq7g-eQTInZnudE,1336
+gemcode/trust.py,sha256=kZi1dll1T8RUZtSY42WbsEh-ZIkMRup_IZPfYlJMbw4,1457
 gemcode/version.py,sha256=uwynYS-RmK8CDoqGtt8976kFkJv0zELkEAlwebnp_io,380
 gemcode/vertex.py,sha256=Fy8zxuU8jWkObt0WDRI0XmgnjNznILXVLVwKjImNz9Q,643
 gemcode/workspace_hints.py,sha256=WQFwyoGnVrzzYSl0s5MNcd1-UP11Ao8KGgrdFIB5m9g,621
 gemcode/computer_use/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gemcode/computer_use/browser_computer.py,sha256=bWXXgj7K6ZrDqT49iPEcnBd_ZJBwRxSgKhzKaJpn4cQ,13212
-gemcode/evals/harness.py,sha256=nn6luhFf5EzIGbTIFRvac36yVlLQRhXoKnfyKbcCaM4,3695
+gemcode/evals/harness.py,sha256=qf2L77cdghBE6uPUTkQQxL9TmgDpN54NwTmyJUFcF14,5232
 gemcode/memory/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gemcode/memory/embedding_memory_service.py,sha256=4iMZUw80GY8SPrJcuT4CwOsTmZ600SOuYkm-nv2c634,9422
 gemcode/memory/file_memory_service.py,sha256=yAXCspfSPBfQXDrwPX8ZZsqaprnC_CKvgmN_GiQVzuo,6092
@@ -91,8 +91,8 @@ gemcode/tools/think.py,sha256=bch9bsz1bs24uia5l3utnNSkT84mIyU_EzMgi82e60Y,1624
 gemcode/tools/todo.py,sha256=dlGfcNce1WsJ5Y9txrDL3SoF6Hv2rms9r1cvGPs6qIs,5798
 gemcode/tools/web.py,sha256=I-6-GgCVKblc9zVFfilWLHoJZfri7_pC2MpT52ZZarE,5078
 gemcode/tools/web_search.py,sha256=YqIvwAoOXK3TMqrrMVeSrg5Nyt7Ou5nRljrYQ4784_4,8816
-gemcode/tui/input_handler.py,sha256=3bW98qgVeJdGeREqhH4U1jH_QWRM6YSZYeyFd2TunUw,11090
-gemcode/tui/scrollback.py,sha256=NLD4YYgya_ouGZSxca_ts42YVK9vp3SL3Ll6tuUiTUA,33076
+gemcode/tui/input_handler.py,sha256=Az8SbPaPHksIoibjph8gevMnfjagR1b-34_wpKbEhgQ,8259
+gemcode/tui/scrollback.py,sha256=BA_hjqdEggnpbq5TZtJbojB7sRRgZ7evQMEQEfeCKoU,33137
 gemcode/tui/spinner.py,sha256=dExs_enBPOWjkmRtodDzRw3E-MYh-xgtqDo54Q82sco,4892
 gemcode/tui/welcome_banner.py,sha256=aocl1lnoyLIM6RN4f65g3i0wRA71RqUlgPrGsXeVLW4,4387
 gemcode/tui/welcome_rich.py,sha256=VERTr2PB8hCdxNftJ827OdilFnnJMMDnqkaqzLne_lQ,4059
@@ -100,9 +100,9 @@ gemcode/web/__init__.py,sha256=EysmUAWs6g-lmMk4VFljKfaHVrEgb_FiIzwQmBdORJc,40
 gemcode/web/sse_adapter.py,sha256=fXhKxn_bdJJUGqlmvkxLNSYL-ZiIZDaLHtQCF_BheRc,7108
 gemcode/web/terminal_repl.py,sha256=fQt895g0qcr6VBhXfv_5b_bsC5zHT5-MO0ysBdgi2Fg,3886
 gemcode/web/web_sse_compat.py,sha256=9A2s-GI7El7AotJqhO263FrLwppCXXkdydZ5EiOQbao,504
-gemcode-0.3.77.dist-info/licenses/LICENSE,sha256=TD4524qn-W8Z07GTDnag-9jJPFutFZNB0a1WbMHPC54,8388
-gemcode-0.3.77.dist-info/METADATA,sha256=d0GwZUIL62wHtRBxK1U5lHYxNJdd_h6yakBqZM_5SdU,33688
-gemcode-0.3.77.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-gemcode-0.3.77.dist-info/entry_points.txt,sha256=cZdLTLDiHbks7OSUCuxCh66dCWeQdpLR8BozoqfEjV4,45
-gemcode-0.3.77.dist-info/top_level.txt,sha256=UYrjULLBY2bcgK6KI6flomJWmsbDXu7n0rvW2SWFrbo,8
-gemcode-0.3.77.dist-info/RECORD,,
+gemcode-0.3.78.dist-info/licenses/LICENSE,sha256=TD4524qn-W8Z07GTDnag-9jJPFutFZNB0a1WbMHPC54,8388
+gemcode-0.3.78.dist-info/METADATA,sha256=LEGVRi0Lfgz12djaXYe11PAzIEpce21QAIzpPQx3tvM,40109
+gemcode-0.3.78.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+gemcode-0.3.78.dist-info/entry_points.txt,sha256=cZdLTLDiHbks7OSUCuxCh66dCWeQdpLR8BozoqfEjV4,45
+gemcode-0.3.78.dist-info/top_level.txt,sha256=UYrjULLBY2bcgK6KI6flomJWmsbDXu7n0rvW2SWFrbo,8
+gemcode-0.3.78.dist-info/RECORD,,