agentram 0.1.3 → 0.1.5

package/README.md

@@ -53,9 +53,10 @@ If using the Claude plugin, `.mcp.json` sets `AGENTRAM_AUTO_INIT=true`, so these
 
 ## Terminal UI CLI
 
-AgentRAM also includes a dependency-free terminal UI with a Claude Code-like chat frame and button menu:
+AgentRAM includes a terminal UI with Claude-like slash autocomplete. It uses `prompt_toolkit` when installed and falls back to plain `input()` otherwise:
 
 ```bash
+pip install -e ".[tui]"
 agentram
 ```
 
@@ -870,3 +871,14 @@ Inside TUI:
 ```
 
 Do not paste raw API keys into `/bind-model`. `api_key_env` means environment variable name, e.g. `OPENAI_API_KEY`.
+
+
+### Optional Rich TUI
+
+For live slash-command dropdown and command metadata, install the optional TUI extra:
+
+```bash
+pip install agentram[tui]
+```
+
+Without `prompt_toolkit`, AgentRAM still works with basic terminal input; `/` then Enter opens the full slash palette.

package/agentram/cli.py

@@ -18,6 +18,30 @@ SUBAGENTS: dict[str, str] = {
     "documenter": "Update README or usage notes from current implementation. Keep docs concise and runnable.",
 }
 
+SLASH_COMMANDS: list[tuple[str, str]] = [
+    ("/help", "Show commands"),
+    ("/init", "Create .agentram files"),
+    ("/status", "Show RAM status"),
+    ("/retrieve <query>", "Print relevant RAM context"),
+    ("/goal", "Show Goal Stack"),
+    ("/set-goal key=value ...", "Update mission/current_goal/current_task/etc"),
+    ("/drift <task>", "Check goal drift"),
+    ("/events", "Show latest events"),
+    ("/replay", "Replay events into memory"),
+    ("/agents", "List Claude-style subagent presets"),
+    ("/agent <name> <task>", "Build Claude Code subagent prompt"),
+    ("/models", "List bound coding models"),
+    ("/bind-model provider model", "Bind model endpoint"),
+    ("/orchestrate <task>", "Build multi-model agent plan"),
+    ("/ask <prompt>", "Execute bound models and return outputs"),
+    ("/claude-install [path]", "Install .claude commands and agents"),
+    ("/note <text>", "Save decision note"),
+    ("/clear", "Clear chat"),
+    ("/exit", "Quit"),
+    ("Plain text", "Capture coding chat message and retrieve context"),
+]
+
+
 SLASH_HELP = """Slash commands:
 /help                         Show commands
 /init                         Create .agentram files
@@ -151,10 +175,19 @@ def run_command(args: argparse.Namespace) -> int:
 
 def run_tui(context: McpContext) -> None:
     context.init_storage()
-    messages = ["system > AgentRAM coding-agent CLI ready", f"system > RAM root: {context.ram_root}", "system > Type /help, /agent reviewer <task>, or plain coding request."]
+    prompt_session = create_prompt_session()
+    input_hint = "live slash autocomplete enabled" if prompt_session else "basic input fallback; install prompt_toolkit for live slash dropdown"
+    messages = [
+        "system > AgentRAM coding-agent CLI ready",
+        f"system > RAM root: {context.ram_root}",
+        f"system > {input_hint}",
+    ]
     while True:
         draw_screen(context, messages)
-        user_input = input("You > ").strip()
+        try:
+            user_input = read_tui_input(prompt_session).strip()
+        except (EOFError, KeyboardInterrupt):
+            return
         if user_input in {"0", "q", "quit", "exit", "/exit", "/quit"}:
             return
         if user_input in BUTTONS:
@@ -170,9 +203,46 @@ def run_tui(context: McpContext) -> None:
         del messages[:-10]
 
 
+
+def slash_command_names() -> list[str]:
+    return [command.split()[0] for command, _ in SLASH_COMMANDS if command.startswith("/")]
+
+
+def slash_command_meta() -> dict[str, str]:
+    return {command.split()[0]: description for command, description in SLASH_COMMANDS if command.startswith("/")}
+
+
+def create_prompt_session() -> Any | None:
+    try:
+        from prompt_toolkit import PromptSession
+        from prompt_toolkit.completion import WordCompleter
+    except ImportError:
+        return None
+
+    completer = WordCompleter(
+        slash_command_names(),
+        meta_dict=slash_command_meta(),
+        ignore_case=True,
+        sentence=True,
+    )
+    return PromptSession(
+        completer=completer,
+        complete_while_typing=True,
+        reserve_space_for_menu=12,
+        bottom_toolbar="Type / for slash commands · /agents for subagents · /ask to call bound models",
+    )
+
+
+def read_tui_input(prompt_session: Any | None) -> str:
+    if prompt_session is None:
+        return input("You > ")
+    return prompt_session.prompt("You > ")
+
 def handle_chat_input(context: McpContext, text: str, messages: list[str] | None = None) -> str:
     if not text:
         return SLASH_HELP
+    if text == "/":
+        return slash_palette_text()
     if text.startswith("/"):
         return handle_slash_command(context, text, messages)
     call_tool(
@@ -313,8 +383,34 @@ def replay_text(context: McpContext, arguments: dict[str, object]) -> str:
 
 
 def agents_text() -> str:
-    lines = ["Subagent presets:"]
-    lines.extend(f"- {name}: {description}" for name, description in SUBAGENTS.items())
+    rows = [
+        ("agentram-memory", "Memory", "Records durable notes. Never edits code."),
+        ("agentram-planner", "Planner", "Checks Goal Stack and decomposes work."),
+        ("agentram-reviewer", "Reviewer", "Reviews changes, tests, and drift risk."),
+        ("agentram-docs", "Docs", "Updates README and usage docs."),
+    ]
+    lines = ["Claude Code subagents", ""]
+    for name, label, description in rows:
+        lines.append(f"  {name.ljust(22)} {label}")
+        lines.append(f"    {description}")
+    lines.append("")
+    lines.append("Use: /agent reviewer <task>")
+    lines.append("Install: /claude-install .")
+    return "\n".join(lines)
+
+
+def slash_palette_text(filter_text: str = "") -> str:
+    normalized = filter_text.strip().lower().lstrip("/")
+    rows = []
+    for command, description in SLASH_COMMANDS:
+        command_key = command.lower().lstrip("/")
+        if normalized and normalized not in command_key:
+            continue
+        rows.append((command, description))
+    command_width = max([len(command) for command, _ in rows] + [12])
+    lines = ["Slash commands", ""]
+    for command, description in rows:
+        lines.append(f"  {command.ljust(command_width)}  {description}")
     return "\n".join(lines)
 
 
@@ -484,7 +580,7 @@ def draw_screen(context: McpContext, messages: list[str]) -> None:
     left_width = 30
     right_width = width - left_width - 3
     print("+" + "-" * (width - 2) + "+")
-    print(box_text("AgentRAM Code Agent CLI  |  RAM + Claude subagents + slash commands", width))
+    print(box_text("◆ AgentRAM Code  |  RAM + Claude subagents + slash commands", width))
     print("+" + "-" * (width - 2) + "+")
 
     sidebar = sidebar_lines(context)
@@ -495,7 +591,7 @@ def draw_screen(context: McpContext, messages: list[str]) -> None:
         right = chat[index] if index < len(chat) else ""
         print("| " + left[: left_width - 2].ljust(left_width - 2) + "| " + right[: right_width - 2].ljust(right_width - 2) + "|")
     print("+" + "-" * (left_width - 1) + "+" + "-" * (right_width) + "+")
-    print(box_text("Input: plain coding request, /help, /agent reviewer <task>, /claude-install .", width))
+    print(box_text("Input: type / for live dropdown. Enter '/' for full palette. /ask calls models.", width))
     print("+" + "-" * (width - 2) + "+")
 
 
@@ -526,10 +622,10 @@ def sidebar_lines(context: McpContext) -> list[str]:
         "  9 help     0 exit",
         "",
         "CLAUDE",
+        "  / = command palette",
+        "  /agents",
         "  /claude-install .",
         "  /models",
-        "  /bind-model claude <model>",
-        "  /orchestrate <task>",
         "  /ask <prompt>",
     ]
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentram",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Async, model-agnostic Working RAM for coding agents.",
   "license": "MIT",
   "homepage": "https://github.com/trancongnghia/AGENT_RAM#readme",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agentram"
-version = "0.1.3"
+version = "0.1.5"
 description = "Async, model-agnostic RAM layer for agentic coding tools."
 readme = "README.md"
 license = "MIT"
@@ -21,6 +21,9 @@ classifiers = [
 requires-python = ">=3.10"
 dependencies = []
 
+[project.optional-dependencies]
+tui = ["prompt_toolkit>=3.0"]
+
 [project.urls]
 Homepage = "https://github.com/your-org/agentram"
 Repository = "https://github.com/your-org/agentram"