feat: add /read command and refresh README tagline

Adds a local /read <path> command that prints file contents to the
terminal with line numbers, so users can inspect files without leaving
the REPL. Strips a leading @ to match the @mention UX; rejects missing
paths, directories, and binary files.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: lzwjava

README.md

@@ -2,7 +2,9 @@
 
 [中文](./README_CN.md)
 
-A minimal [openclaw](https://github.com/lzwjava/openclaw) implementation for enterprise-constrained environments. iclaw is a lightweight terminal REPL that provides AI-assisted coding via GitHub Copilot, designed to work where full-featured tools are blocked or restricted — no browser extensions, no IDE plugins, just a plain Python CLI.
+A terminal AI agent that codes, searches, and runs commands for you — works on personal machines and locked-down enterprise ones.
+
+A minimal [openclaw](https://github.com/lzwjava/openclaw) implementation, built as a plain Python CLI with no browser extensions or IDE plugins, powered by GitHub Copilot.
 
 *Disclaimer: All tests with Copilot were performed using my personal subscription and personal account.*
 
@@ -54,6 +56,7 @@ pip install -e .
 - `/ca_bundle`: Set CA bundle for HTTPS (usage: `/ca_bundle [path|off]`).
 - `/log`: Set log verbosity (usage: `/log [verbose|info]`).
 - `/copy`: Copy last response to clipboard.
+- `/read`: Print file contents to terminal (usage: `/read <path>`).
 - `/clear`: Clear conversation history.
 - `/compact`: Compact conversation history using LLM.
 - `/export`: Export full conversation history to JSON file.

iclaw/commands/read.py

@@ -0,0 +1,46 @@
+import os
+import sys
+
+
+def _is_binary(data):
+    return b"\x00" in data
+
+
+def handle_read_command(arg):
+    if not arg:
+        print("Usage: /read <path>", file=sys.stderr)
+        return
+
+    path = arg.strip()
+    if path.startswith("@"):
+        path = path[1:]
+
+    if not os.path.exists(path):
+        print(f"No such file: {path}", file=sys.stderr)
+        return
+    if os.path.isdir(path):
+        print(f"Is a directory: {path}", file=sys.stderr)
+        return
+
+    try:
+        with open(path, "rb") as f:
+            raw = f.read()
+    except OSError as e:
+        print(f"Error reading {path}: {e}", file=sys.stderr)
+        return
+
+    if _is_binary(raw):
+        print(f"Binary file: {path} ({len(raw)} bytes)", file=sys.stderr)
+        return
+
+    try:
+        text = raw.decode("utf-8")
+    except UnicodeDecodeError:
+        text = raw.decode("utf-8", errors="replace")
+
+    lines = text.splitlines()
+    print(f"\n{path} — {len(lines)} lines")
+    width = len(str(len(lines))) if lines else 1
+    for i, line in enumerate(lines, 1):
+        print(f"{i:>{width}}  {line}")
+    print()

iclaw/completer.py

@@ -12,6 +12,7 @@
     "/ca_bundle",
     "/log",
     "/copy",
+    "/read",
     "/status",
     "/help",
     "/clear",

iclaw/main.py

@@ -14,6 +14,7 @@
 from iclaw.commands.log import handle_log_command
 from iclaw.commands.model import handle_model_command, handle_model_provider_command
 from iclaw.commands.proxy import handle_ca_bundle_command, handle_proxy_command
+from iclaw.commands.read import handle_read_command
 from iclaw.commands.search_provider import handle_search_provider_command
 from iclaw.commands.utils import handle_copy_command
 from iclaw.completer import IclawCompleter
@@ -39,6 +40,7 @@
     ("/ca_bundle", "Set CA bundle for HTTPS (usage: /ca_bundle [path|off])"),
     ("/log", "Set log verbosity (usage: /log [verbose|info])"),
     ("/copy", "Copy last Copilot response to clipboard"),
+    ("/read", "Print file contents to terminal (usage: /read <path>)"),
     ("/clear", "Clear conversation history"),
     ("/compact", "Compact conversation history using LLM"),
     ("/export", "Export full conversation history to JSON file"),
@@ -115,6 +117,11 @@ def main():
         if user_input == "/copy":
             handle_copy_command(last_reply)
             continue
+        if user_input == "/read" or user_input.startswith("/read "):
+            parts = user_input.split(maxsplit=1)
+            arg = parts[1] if len(parts) > 1 else None
+            handle_read_command(arg)
+            continue
         if user_input == "/provider_model":
             p, t = handle_model_provider_command(CONFIG_PATH, model_provider)
             if t: