@ridit/lens 0.1.7 → 0.1.9

package/dist/index.mjs

@@ -48707,10 +48707,10 @@ More content."}
 ### 11. search — search the internet for anything you are unsure about
 <search>how to use React useEffect cleanup function</search>
 
-### 11. clone — clone a GitHub repo so you can explore and discuss it
+### 12. clone — clone a GitHub repo so you can explore and discuss it
 <clone>https://github.com/owner/repo</clone>
 
-### 12. changes — propose code edits (shown as a diff for user approval)
+### 13. changes — propose code edits (shown as a diff for user approval)
 <changes>
 {"summary": "what changed and why", "patches": [{"path": "src/foo.ts", "content": "COMPLETE file content", "isNew": false}]}
 </changes>
@@ -48729,16 +48729,20 @@ More content."}
 10. shell is ONLY for running code, installing packages, building, testing — not for filesystem inspection
 11. write-file content field must be the COMPLETE file content, never empty or placeholder
 12. After a write-file succeeds, do NOT repeat it — trust the result and move on
-13. After a write-file succeeds, use read-file to verify the content before telling the user it is done
+13. After a write-file succeeds, tell the user it is done immediately — do NOT auto-read the file back to verify
 14. NEVER apologize and redo a tool call you already made — if write-file or shell ran and returned a result, it worked, do not run it again
 15. NEVER say "I made a mistake" and repeat the same tool — one attempt is enough, trust the output
 16. NEVER second-guess yourself mid-response — commit to your answer
 17. If a read-folder or read-file returns "not found", accept it and move on — do NOT retry the same path
 18. If you have already retrieved a result for a path in this conversation, do NOT request it again — use the result you already have
-17. Every shell command runs from the repo root — \`cd\` has NO persistent effect. NEVER use \`cd\` alone. Use full paths or combine with && e.g. \`cd list && bun run index.ts\`
-18. write-file paths are relative to the repo root — if creating files in a subfolder write the full relative path e.g. \`list/src/index.tsx\` NOT \`src/index.tsx\`
-19. When scaffolding a new project in a subfolder, ALL write-file paths must start with that subfolder name e.g. \`list/package.json\`, \`list/src/index.tsx\`
-20. For JSX/TSX files always use \`.tsx\` extension and include \`/** @jsxImportSource react */\` or ensure tsconfig has jsx set — bun needs this to parse JSX
+19. Every shell command runs from the repo root — \`cd\` has NO persistent effect. NEVER use \`cd\` alone. Use full paths or combine with && e.g. \`cd list && bun run index.ts\`
+20. write-file paths are relative to the repo root — if creating files in a subfolder write the full relative path e.g. \`list/src/index.tsx\` NOT \`src/index.tsx\`
+21. When scaffolding a new project in a subfolder, ALL write-file paths must start with that subfolder name e.g. \`list/package.json\`, \`list/src/index.tsx\`
+22. For JSX/TSX files always use \`.tsx\` extension and include \`/** @jsxImportSource react */\` or ensure tsconfig has jsx set — bun needs this to parse JSX
+23. When explaining how to use a tool in text, use [tag] bracket notation or a fenced code block — NEVER emit a real XML tool tag as part of an explanation or example
+24. NEVER chain tool calls unless the user's request explicitly requires multiple steps
+25. NEVER read files, list folders, or run tools that were not asked for in the current user message
+26. NEVER use markdown formatting in plain text responses — no **bold**, no *italics*, no # headings, no bullet points with -, *, or +, no numbered lists, no backtick inline code. Write in plain prose. Only use fenced \`\`\` code blocks when showing actual code.
 
 ## CRITICAL: READ BEFORE YOU WRITE
 
@@ -48952,6 +48956,22 @@ Please continue your response based on this output.`
     role: "assistant",
     content: "`useInput` is used in `src/components/chat/ChatRunner.tsx` — imported on line 5 and called on line 210."
   },
+  {
+    role: "user",
+    content: "show me how to use the read-file tool"
+  },
+  {
+    role: "assistant",
+    content: "To read a file, emit the tag alone in your response — nothing else on that turn:\n\n```text\n[read-file]src/components/Header.tsx[/read-file]\n```\n\nThe result comes back as the next user message and you can then analyze it."
+  },
+  {
+    role: "user",
+    content: "show me an example of the shell tool"
+  },
+  {
+    role: "assistant",
+    content: "To run a shell command, emit only the tag:\n\n```text\n[shell]node -v[/shell]\n```\n\nThe stdout/stderr is returned and you can read it in the next turn."
+  },
   {
     role: "user",
     content: "read src folder"
@@ -49187,21 +49207,29 @@ Please continue your response based on this output.`
   },
   {
     role: "assistant",
-    content: "<read-file>ts-info.json</read-file>"
+    content: "Done — `ts-info.json` has been saved."
   },
   {
     role: "user",
-    content: `Here is the output from read-file of ts-info.json:
-
-File: ts-info.json (1 lines)
+    content: "write it to a file called hello.py"
+  },
+  {
+    role: "assistant",
+    content: `<write-file>
+{"path": "hello.py", "content": "# hello.py\\nprint('hello')"}
+</write-file>`
+  },
+  {
+    role: "user",
+    content: `Here is the output from write-file to hello.py:
 
-{"name":"TypeScript","stars":100000}
+Written: /repo/hello.py (2 lines, 32 bytes)
 
 Please continue your response based on this output.`
   },
   {
     role: "assistant",
-    content: "Done — saved and verified `ts-info.json`. Data looks correct."
+    content: "Done — `hello.py` has been written."
   },
   {
     role: "user",
@@ -49283,9 +49311,18 @@ Please continue your response based on this output.`
   {
     role: "assistant",
     content: "The `??` operator is the nullish coalescing operator. It returns the right side only when the left side is `null` or `undefined`."
+  },
+  {
+    role: "user",
+    content: "what does this project do?"
+  },
+  {
+    role: "assistant",
+    content: "This project is a CLI coding assistant that lets you chat with an AI model about your codebase. It can read and write files, run shell commands, search the web, and propose diffs for your approval."
   }
 ];
 function parseResponse(text) {
+  const scanText = text.replace(/```[\s\S]*?```/g, (m) => " ".repeat(m.length));
   const candidates = [];
   const patterns = [
     { kind: "fetch", re: /<fetch>([\s\S]*?)<\/fetch>/g },
@@ -49314,16 +49351,25 @@ function parseResponse(text) {
   ];
   for (const { kind: kind2, re } of patterns) {
     re.lastIndex = 0;
-    const m = re.exec(text);
-    if (m)
-      candidates.push({ index: m.index, kind: kind2, match: m });
+    const m = re.exec(scanText);
+    if (m) {
+      const originalRe = new RegExp(re.source, re.flags.replace("g", ""));
+      const originalMatch = originalRe.exec(text.slice(m.index));
+      if (originalMatch) {
+        const fakeMatch = Object.assign([
+          text.slice(m.index, m.index + originalMatch[0].length),
+          originalMatch[1]
+        ], { index: m.index, input: text, groups: undefined });
+        candidates.push({ index: m.index, kind: kind2, match: fakeMatch });
+      }
+    }
   }
   if (candidates.length === 0)
     return { kind: "text", content: text.trim() };
   candidates.sort((a, b) => a.index - b.index);
   const { kind, match } = candidates[0];
   const before2 = text.slice(0, match.index).replace(/<(fetch|shell|read-file|read-folder|write-file|search|clone|changes)[^>]*>[\s\S]*?<\/\1>/g, "").trim();
-  const body = match[1].trim();
+  const body = (match[1] ?? "").trim();
   if (kind === "changes") {
     try {
       const parsed = JSON.parse(body);
@@ -49426,7 +49472,7 @@ Please continue your response based on this output.`
     return { role: m.role, content: m.content };
   });
 }
-async function callChat(provider, systemPrompt, messages) {
+async function callChat(provider, systemPrompt, messages, abortSignal) {
   const apiMessages = [...FEW_SHOT_MESSAGES, ...buildApiMessages(messages)];
   let url;
   let headers;
@@ -49459,6 +49505,7 @@ async function callChat(provider, systemPrompt, messages) {
   }
   const controller = new AbortController;
   const timer = setTimeout(() => controller.abort(), 60000);
+  abortSignal?.addEventListener("abort", () => controller.abort());
   const res = await fetch(url, {
     method: "POST",
     headers,
@@ -50010,7 +50057,6 @@ for line in raw.split("\\n"):
     elif s == "":
         story.append(Spacer(1, 6))
     else:
-        # handle **bold** inline
         import re
         s = re.sub(r"\\*\\*(.+?)\\*\\*", r"<b>\\1</b>", s)
         s = re.sub(r"\\*(.+?)\\*", r"<i>\\1</i>", s)
@@ -50063,23 +50109,15 @@ function InlineText({ text }) {
 function CodeBlock({ lang, code }) {
   return /* @__PURE__ */ jsx_dev_runtime19.jsxDEV(Box_default, {
     flexDirection: "column",
-    marginY: 1,
-    marginLeft: 2,
-    children: [
-      lang && /* @__PURE__ */ jsx_dev_runtime19.jsxDEV(Text, {
-        color: "gray",
-        children: lang
-      }, undefined, false, undefined, this),
-      code.split(`
+    children: code.split(`
 `).map((line, i) => /* @__PURE__ */ jsx_dev_runtime19.jsxDEV(Text, {
-        color: ACCENT,
-        children: [
-          "  ",
-          line
-        ]
-      }, i, true, undefined, this))
-    ]
-  }, undefined, true, undefined, this);
+      color: ACCENT,
+      children: [
+        "  ",
+        line
+      ]
+    }, i, true, undefined, this))
+  }, undefined, false, undefined, this);
 }
 function MessageBody({ content }) {
   const segments = content.split(/(```[\s\S]*?```)/g);
@@ -50149,6 +50187,9 @@ function StaticMessage({ msg }) {
     return /* @__PURE__ */ jsx_dev_runtime19.jsxDEV(Box_default, {
       marginBottom: 1,
       gap: 1,
+      backgroundColor: "#1a1a1a",
+      paddingLeft: 1,
+      paddingRight: 2,
       children: [
         /* @__PURE__ */ jsx_dev_runtime19.jsxDEV(Text, {
           color: "gray",
@@ -50167,12 +50208,6 @@ function StaticMessage({ msg }) {
       shell: "$",
       fetch: "~>",
       "read-file": "r",
-      "read-folder": "d",
-      grep: "/",
-      "delete-file": "x",
-      "delete-folder": "X",
-      "open-url": "↗",
-      "generate-pdf": "P",
       "write-file": "w",
       search: "?"
     };
@@ -52349,6 +52384,7 @@ var ChatRunner = ({ repoPath }) => {
   const [showTimeline, setShowTimeline] = import_react48.useState(false);
   const [showReview, setShowReview] = import_react48.useState(false);
   const [autoApprove, setAutoApprove] = import_react48.useState(false);
+  const abortControllerRef = import_react48.useRef(null);
   const toolResultCache = import_react48.useRef(new Map);
   const inputBuffer = import_react48.useRef("");
   const flushTimer = import_react48.useRef(null);
@@ -52369,6 +52405,10 @@ var ChatRunner = ({ repoPath }) => {
     }, 16);
   };
   const handleError = (currentAll) => (err) => {
+    if (err instanceof Error && err.name === "AbortError") {
+      setStage({ type: "idle" });
+      return;
+    }
     const errMsg = {
       role: "assistant",
       content: `Error: ${err instanceof Error ? err.message : "Something went wrong"}`,
@@ -52378,7 +52418,11 @@ var ChatRunner = ({ repoPath }) => {
     setCommitted((prev) => [...prev, errMsg]);
     setStage({ type: "idle" });
   };
-  const processResponse = (raw, currentAll) => {
+  const processResponse = (raw, currentAll, signal) => {
+    if (signal.aborted) {
+      setStage({ type: "idle" });
+      return;
+    }
     const parsed = parseResponse(raw);
     if (parsed.kind === "changes") {
       if (parsed.patches.length === 0) {
@@ -52532,8 +52576,10 @@ var ChatRunner = ({ repoPath }) => {
         const withTool = [...currentAll, toolMsg];
         setAllMessages(withTool);
         setCommitted((prev) => [...prev, toolMsg]);
+        const nextAbort = new AbortController;
+        abortControllerRef.current = nextAbort;
         setStage({ type: "thinking" });
-        callChat(provider, systemPrompt, withTool).then((r) => processResponse(r, withTool)).catch(handleError(withTool));
+        callChat(provider, systemPrompt, withTool, nextAbort.signal).then((r) => processResponse(r, withTool, nextAbort.signal)).catch(handleError(withTool));
       };
       if (autoApprove && isSafeTool) {
         executeAndContinue(true);
@@ -52621,12 +52667,20 @@ var ChatRunner = ({ repoPath }) => {
     setCommitted((prev) => [...prev, userMsg]);
     setAllMessages(nextAll);
     toolResultCache.current.clear();
+    const abort = new AbortController;
+    abortControllerRef.current = abort;
     setStage({ type: "thinking" });
-    callChat(provider, systemPrompt, nextAll).then((raw) => processResponse(raw, nextAll)).catch(handleError(nextAll));
+    callChat(provider, systemPrompt, nextAll, abort.signal).then((raw) => processResponse(raw, nextAll, abort.signal)).catch(handleError(nextAll));
   };
   use_input_default((input, key) => {
     if (showTimeline)
       return;
+    if (stage.type === "thinking" && key.escape) {
+      abortControllerRef.current?.abort();
+      abortControllerRef.current = null;
+      setStage({ type: "idle" });
+      return;
+    }
     if (stage.type === "idle") {
       if (key.ctrl && input === "c") {
         process.exit(0);
@@ -52958,6 +53012,11 @@ Tip: type /timeline to browse commit history.`,
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsx_dev_runtime22.jsxDEV(TypewriterText, {
             text: thinkingPhrase
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsx_dev_runtime22.jsxDEV(Text, {
+            color: "gray",
+            dimColor: true,
+            children: "· esc cancel"
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this),

package/hello.py

@@ -0,0 +1,51 @@
+# hello.py
+# A simple script that reads a text file, makes an HTTP request,
+# and prints the result in a friendly way.
+
+import json
+import pathlib
+import sys
+from urllib.request import urlopen
+
+def read_local_file(path: str) -> str:
+    """Read the contents of a file and return it as a string."""
+    file_path = pathlib.Path(path)
+    if not file_path.is_file():
+        raise FileNotFoundError(f"❌ File not found: {path}")
+    return file_path.read_text(encoding="utf-8")
+
+def fetch_json(url: str) -> dict:
+    """Fetch JSON from a URL and decode it into a Python dict."""
+    with urlopen(url) as response:
+        if response.status != 200:
+            raise RuntimeError(f"❌ HTTP {response.status} from {url}")
+        data = response.read()
+        return json.loads(data)
+
+def main():
+    # 1️⃣ Read a local file (optional – you can comment this out)
+    try:
+        local_content = read_local_file("example.txt")
+        print("📄 Contents of example.txt:")
+        print(local_content)
+    except FileNotFoundError:
+        print("⚠️ example.txt not found – skipping that step.")
+
+    # 2️⃣ Fetch some JSON data from a public API
+    url = "https://api.github.com/repos/python/cpython"
+    print(f"\n🌐 Fetching data from {url} …")
+    repo_info = fetch_json(url)
+
+    # 3️⃣ Extract a couple of useful fields and display them
+    name = repo_info.get("name")
+    stars = repo_info.get("stargazers_count")
+    description = repo_info.get("description")
+    print("\n🔎 Repository info:")
+    print(f"• Name: {name}")
+    print(f"• Stars: {stars:,}")          # adds commas for readability
+    print(f"• Description: {description}")
+
+    return 0
+
+if __name__ == "__main__":
+    sys.exit(main())

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ridit/lens",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Know Your Codebase.",
   "author": "Ridit Jangra <riditjangra09@gmail.com> (https://ridit.space)",
   "license": "MIT",
@@ -18,7 +18,6 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "figures": "^6.1.0",
     "ink": "^6.8.0",
@@ -26,7 +25,8 @@
     "ink-text-input": "^6.0.0",
     "nanoid": "^5.1.6",
     "react": "^19.2.4",
-    "react-devtools-core": "^7.0.1"
+    "react-devtools-core": "^7.0.1",
+    "sugar-high": "^0.9.5"
   },
   "devDependencies": {
     "@types/bun": "latest",

package/src/colors.ts

@@ -1 +1,10 @@
 export const ACCENT = "#DA7758";
+
+export const TOKEN_KEYWORD = "#B385C9";
+export const TOKEN_STRING = "#85C98A";
+export const TOKEN_NUMBER = "#E8C170";
+export const TOKEN_PROPERTY = "#79C5D4";
+export const TOKEN_ENTITY = "#7AABDB";
+export const TOKEN_TEXT = "#E8E8E8";
+export const TOKEN_MUTED = "#888888";
+export const TOKEN_COMMENT = "#777777";

package/src/components/chat/ChatMessage.tsx

@@ -34,8 +34,7 @@ function InlineText({ text }: { text: string }) {
 
 function CodeBlock({ lang, code }: { lang: string; code: string }) {
   return (
-    <Box flexDirection="column" marginY={1} marginLeft={2}>
-      {lang && <Text color="gray">{lang}</Text>}
+    <Box flexDirection="column">
       {code.split("\n").map((line, i) => (
         <Text key={i} color={ACCENT}>
           {"  "}
@@ -102,7 +101,13 @@ function MessageBody({ content }: { content: string }) {
 export function StaticMessage({ msg }: { msg: Message }) {
   if (msg.role === "user") {
     return (
-      <Box marginBottom={1} gap={1}>
+      <Box
+        marginBottom={1}
+        gap={1}
+        backgroundColor={"#1a1a1a"}
+        paddingLeft={1}
+        paddingRight={2}
+      >
         <Text color="gray">{">"}</Text>
         <Text color="white" bold>
           {msg.content}
@@ -116,12 +121,6 @@ export function StaticMessage({ msg }: { msg: Message }) {
       shell: "$",
       fetch: "~>",
       "read-file": "r",
-      "read-folder": "d",
-      grep: "/",
-      "delete-file": "x",
-      "delete-folder": "X",
-      "open-url": "↗",
-      "generate-pdf": "P",
       "write-file": "w",
       search: "?",
     };

package/src/components/chat/ChatRunner.tsx

@@ -107,6 +107,10 @@ export const ChatRunner = ({ repoPath }: { repoPath: string }) => {
   const [showReview, setShowReview] = useState(false);
   const [autoApprove, setAutoApprove] = useState(false);
 
+  // Abort controller for the currently in-flight API call.
+  // Pressing ESC while thinking aborts the request and drops the response.
+  const abortControllerRef = useRef<AbortController | null>(null);
+
   // Cache of tool results within a single conversation turn to prevent
   // the model from re-calling tools it already ran with the same args
   const toolResultCache = useRef<Map<string, string>>(new Map());
@@ -131,6 +135,11 @@ export const ChatRunner = ({ repoPath }: { repoPath: string }) => {
   };
 
   const handleError = (currentAll: Message[]) => (err: unknown) => {
+    // Silently drop aborted requests — user pressed ESC intentionally
+    if (err instanceof Error && err.name === "AbortError") {
+      setStage({ type: "idle" });
+      return;
+    }
     const errMsg: Message = {
       role: "assistant",
       content: `Error: ${err instanceof Error ? err.message : "Something went wrong"}`,
@@ -141,7 +150,17 @@ export const ChatRunner = ({ repoPath }: { repoPath: string }) => {
     setStage({ type: "idle" });
   };
 
-  const processResponse = (raw: string, currentAll: Message[]) => {
+  const processResponse = (
+    raw: string,
+    currentAll: Message[],
+    signal: AbortSignal,
+  ) => {
+    // If ESC was pressed before we got here, silently drop the response
+    if (signal.aborted) {
+      setStage({ type: "idle" });
+      return;
+    }
+
     const parsed = parseResponse(raw);
 
     if (parsed.kind === "changes") {
@@ -245,7 +264,6 @@ export const ChatRunner = ({ repoPath }: { repoPath: string }) => {
       const executeAndContinue = async (approved: boolean) => {
         let result = "(denied by user)";
         if (approved) {
-          // Build a cache key for idempotent read-only tools
           const cacheKey =
             parsed.kind === "read-file"
               ? `read-file:${parsed.filePath}`
@@ -256,7 +274,6 @@ export const ChatRunner = ({ repoPath }: { repoPath: string }) => {
                   : null;
 
           if (cacheKey && toolResultCache.current.has(cacheKey)) {
-            // Return cached result with a note so the model stops retrying
             result =
               toolResultCache.current.get(cacheKey)! +
               "\n\n[NOTE: This result was already retrieved earlier. Do not request it again.]";
@@ -294,7 +311,6 @@ export const ChatRunner = ({ repoPath }: { repoPath: string }) => {
               } else if (parsed.kind === "search") {
                 result = await searchWeb(parsed.query);
               }
-              // Store result in cache for cacheable tools
               if (cacheKey) {
                 toolResultCache.current.set(cacheKey, result);
               }
@@ -402,9 +418,13 @@ export const ChatRunner = ({ repoPath }: { repoPath: string }) => {
         setAllMessages(withTool);
         setCommitted((prev) => [...prev, toolMsg]);
 
+        // Create a fresh abort controller for the follow-up call
+        const nextAbort = new AbortController();
+        abortControllerRef.current = nextAbort;
+
         setStage({ type: "thinking" });
-        callChat(provider!, systemPrompt, withTool)
-          .then((r: string) => processResponse(r, withTool))
+        callChat(provider!, systemPrompt, withTool, nextAbort.signal)
+          .then((r: string) => processResponse(r, withTool, nextAbort.signal))
           .catch(handleError(withTool));
       };
 
@@ -510,15 +530,28 @@ export const ChatRunner = ({ repoPath }: { repoPath: string }) => {
     setCommitted((prev) => [...prev, userMsg]);
     setAllMessages(nextAll);
     toolResultCache.current.clear();
+
+    // Create a fresh abort controller for this request
+    const abort = new AbortController();
+    abortControllerRef.current = abort;
+
     setStage({ type: "thinking" });
-    callChat(provider, systemPrompt, nextAll)
-      .then((raw: string) => processResponse(raw, nextAll))
+    callChat(provider, systemPrompt, nextAll, abort.signal)
+      .then((raw: string) => processResponse(raw, nextAll, abort.signal))
       .catch(handleError(nextAll));
   };
 
   useInput((input, key) => {
     if (showTimeline) return;
 
+    // ESC while thinking → abort the in-flight request and go idle
+    if (stage.type === "thinking" && key.escape) {
+      abortControllerRef.current?.abort();
+      abortControllerRef.current = null;
+      setStage({ type: "idle" });
+      return;
+    }
+
     if (stage.type === "idle") {
       if (key.ctrl && input === "c") {
         process.exit(0);
@@ -844,6 +877,9 @@ Suggestions: ${lensFile.suggestions.slice(0, 3).join("; ")}`
         <Box gap={1}>
           <Text color={ACCENT}>●</Text>
           <TypewriterText text={thinkingPhrase} />
+          <Text color="gray" dimColor>
+            · esc cancel
+          </Text>
         </Box>
       )}
 

package/src/utils/chat.ts

@@ -69,10 +69,10 @@ You have exactly eleven tools. To use a tool you MUST wrap it in the exact XML t
 ### 11. search — search the internet for anything you are unsure about
 <search>how to use React useEffect cleanup function</search>
 
-### 11. clone — clone a GitHub repo so you can explore and discuss it
+### 12. clone — clone a GitHub repo so you can explore and discuss it
 <clone>https://github.com/owner/repo</clone>
 
-### 12. changes — propose code edits (shown as a diff for user approval)
+### 13. changes — propose code edits (shown as a diff for user approval)
 <changes>
 {"summary": "what changed and why", "patches": [{"path": "src/foo.ts", "content": "COMPLETE file content", "isNew": false}]}
 </changes>
@@ -91,16 +91,20 @@ You have exactly eleven tools. To use a tool you MUST wrap it in the exact XML t
 10. shell is ONLY for running code, installing packages, building, testing — not for filesystem inspection
 11. write-file content field must be the COMPLETE file content, never empty or placeholder
 12. After a write-file succeeds, do NOT repeat it — trust the result and move on
-13. After a write-file succeeds, use read-file to verify the content before telling the user it is done
+13. After a write-file succeeds, tell the user it is done immediately — do NOT auto-read the file back to verify
 14. NEVER apologize and redo a tool call you already made — if write-file or shell ran and returned a result, it worked, do not run it again
 15. NEVER say "I made a mistake" and repeat the same tool — one attempt is enough, trust the output
 16. NEVER second-guess yourself mid-response — commit to your answer
 17. If a read-folder or read-file returns "not found", accept it and move on — do NOT retry the same path
 18. If you have already retrieved a result for a path in this conversation, do NOT request it again — use the result you already have
-17. Every shell command runs from the repo root — \`cd\` has NO persistent effect. NEVER use \`cd\` alone. Use full paths or combine with && e.g. \`cd list && bun run index.ts\`
-18. write-file paths are relative to the repo root — if creating files in a subfolder write the full relative path e.g. \`list/src/index.tsx\` NOT \`src/index.tsx\`
-19. When scaffolding a new project in a subfolder, ALL write-file paths must start with that subfolder name e.g. \`list/package.json\`, \`list/src/index.tsx\`
-20. For JSX/TSX files always use \`.tsx\` extension and include \`/** @jsxImportSource react */\` or ensure tsconfig has jsx set — bun needs this to parse JSX
+19. Every shell command runs from the repo root — \`cd\` has NO persistent effect. NEVER use \`cd\` alone. Use full paths or combine with && e.g. \`cd list && bun run index.ts\`
+20. write-file paths are relative to the repo root — if creating files in a subfolder write the full relative path e.g. \`list/src/index.tsx\` NOT \`src/index.tsx\`
+21. When scaffolding a new project in a subfolder, ALL write-file paths must start with that subfolder name e.g. \`list/package.json\`, \`list/src/index.tsx\`
+22. For JSX/TSX files always use \`.tsx\` extension and include \`/** @jsxImportSource react */\` or ensure tsconfig has jsx set — bun needs this to parse JSX
+23. When explaining how to use a tool in text, use [tag] bracket notation or a fenced code block — NEVER emit a real XML tool tag as part of an explanation or example
+24. NEVER chain tool calls unless the user's request explicitly requires multiple steps
+25. NEVER read files, list folders, or run tools that were not asked for in the current user message
+26. NEVER use markdown formatting in plain text responses — no **bold**, no *italics*, no # headings, no bullet points with -, *, or +, no numbered lists, no backtick inline code. Write in plain prose. Only use fenced \`\`\` code blocks when showing actual code.
 
 ## CRITICAL: READ BEFORE YOU WRITE
 
@@ -179,9 +183,8 @@ ${historySummary}`;
 }
 
 // ── Few-shot examples ─────────────────────────────────────────────────────────
-
 export const FEW_SHOT_MESSAGES: { role: string; content: string }[] = [
-  // read-folder examples FIRST — highest priority pattern to establish
+  // ── delete / open / pdf ───────────────────────────────────────────────────
   {
     role: "user",
     content: "delete src/old-component.tsx",
@@ -253,6 +256,8 @@ export const FEW_SHOT_MESSAGES: { role: string; content: string }[] = [
     role: "assistant",
     content: "Done — the PDF report has been saved to `docs/report.pdf`.",
   },
+
+  // ── grep ──────────────────────────────────────────────────────────────────
   {
     role: "user",
     content: 'grep -R "ChatRunner" -n src',
@@ -289,6 +294,28 @@ export const FEW_SHOT_MESSAGES: { role: string; content: string }[] = [
     content:
       "`useInput` is used in `src/components/chat/ChatRunner.tsx` — imported on line 5 and called on line 210.",
   },
+
+  // ── showing tool usage as an example (bracket notation, NOT real tags) ────
+  {
+    role: "user",
+    content: "show me how to use the read-file tool",
+  },
+  {
+    role: "assistant",
+    content:
+      "To read a file, emit the tag alone in your response — nothing else on that turn:\n\n```text\n[read-file]src/components/Header.tsx[/read-file]\n```\n\nThe result comes back as the next user message and you can then analyze it.",
+  },
+  {
+    role: "user",
+    content: "show me an example of the shell tool",
+  },
+  {
+    role: "assistant",
+    content:
+      "To run a shell command, emit only the tag:\n\n```text\n[shell]node -v[/shell]\n```\n\nThe stdout/stderr is returned and you can read it in the next turn.",
+  },
+
+  // ── read-folder ───────────────────────────────────────────────────────────
   {
     role: "user",
     content: "read src folder",
@@ -415,6 +442,8 @@ export const FEW_SHOT_MESSAGES: { role: string; content: string }[] = [
     content:
       "The repo root contains `package.json` and `README.md`, with source code in `src/` and compiled output in `dist/`.",
   },
+
+  // ── fetch → write → done (no auto-verify) ────────────────────────────────
   {
     role: "user",
     content: "fetch https://api.github.com/repos/microsoft/typescript",
@@ -449,17 +478,30 @@ export const FEW_SHOT_MESSAGES: { role: string; content: string }[] = [
   },
   {
     role: "assistant",
-    content: "<read-file>ts-info.json</read-file>",
+    content: "Done — `ts-info.json` has been saved.",
+  },
+
+  // ── write it to a file → done, nothing else ───────────────────────────────
+  {
+    role: "user",
+    content: "write it to a file called hello.py",
+  },
+  {
+    role: "assistant",
+    content:
+      '<write-file>\n{"path": "hello.py", "content": "# hello.py\\nprint(\'hello\')"}\n</write-file>',
   },
   {
     role: "user",
     content:
-      'Here is the output from read-file of ts-info.json:\n\nFile: ts-info.json (1 lines)\n\n{"name":"TypeScript","stars":100000}\n\nPlease continue your response based on this output.',
+      "Here is the output from write-file to hello.py:\n\nWritten: /repo/hello.py (2 lines, 32 bytes)\n\nPlease continue your response based on this output.",
   },
   {
     role: "assistant",
-    content: "Done — saved and verified `ts-info.json`. Data looks correct.",
+    content: "Done — `hello.py` has been written.",
   },
+
+  // ── read before write ─────────────────────────────────────────────────────
   {
     role: "user",
     content: "add a logout button to src/components/Header.tsx",
@@ -478,6 +520,8 @@ export const FEW_SHOT_MESSAGES: { role: string; content: string }[] = [
     content:
       '<changes>\n{"summary": "Add logout button to Header — preserves all existing nav items and imports", "patches": [{"path": "src/components/Header.tsx", "content": "// complete file with logout button added", "isNew": false}]}\n</changes>',
   },
+
+  // ── shell ─────────────────────────────────────────────────────────────────
   {
     role: "user",
     content: "what node version am I on",
@@ -495,6 +539,8 @@ export const FEW_SHOT_MESSAGES: { role: string; content: string }[] = [
     role: "assistant",
     content: "You're running Node.js v20.11.0.",
   },
+
+  // ── clone ─────────────────────────────────────────────────────────────────
   {
     role: "user",
     content: "clone https://github.com/facebook/react",
@@ -513,6 +559,8 @@ export const FEW_SHOT_MESSAGES: { role: string; content: string }[] = [
     content:
       "Cloned! The React repo has 2847 files. I can read source files, explain how it works, or suggest improvements — just ask.",
   },
+
+  // ── search ────────────────────────────────────────────────────────────────
   {
     role: "user",
     content: "what does the ?? operator do in typescript",
@@ -531,8 +579,16 @@ export const FEW_SHOT_MESSAGES: { role: string; content: string }[] = [
     content:
       "The `??` operator is the nullish coalescing operator. It returns the right side only when the left side is `null` or `undefined`.",
   },
+  {
+    role: "user",
+    content: "what does this project do?",
+  },
+  {
+    role: "assistant",
+    content:
+      "This project is a CLI coding assistant that lets you chat with an AI model about your codebase. It can read and write files, run shell commands, search the web, and propose diffs for your approval.",
+  },
 ];
-
 // ── Response parser ───────────────────────────────────────────────────────────
 
 export type ParsedResponse =
@@ -562,6 +618,10 @@ export type ParsedResponse =
   | { kind: "clone"; content: string; repoUrl: string };
 
 export function parseResponse(text: string): ParsedResponse {
+  // Strip fenced code blocks before scanning for tool tags so that tags shown
+  // as examples inside ``` ... ``` blocks are never executed.
+  const scanText = text.replace(/```[\s\S]*?```/g, (m) => " ".repeat(m.length));
+
   type Candidate = {
     index: number;
     kind:
@@ -610,15 +670,32 @@ export function parseResponse(text: string): ParsedResponse {
 
   for (const { kind, re } of patterns) {
     re.lastIndex = 0;
-    const m = re.exec(text);
-    if (m) candidates.push({ index: m.index, kind, match: m });
+    // Scan against the code-block-stripped text so tags inside ``` are ignored
+    const m = re.exec(scanText);
+    if (m) {
+      // Re-extract the match body from the original text at the same position
+      const originalRe = new RegExp(re.source, re.flags.replace("g", ""));
+      const originalMatch = originalRe.exec(text.slice(m.index));
+      if (originalMatch) {
+        // Reconstruct a match-like object with the correct index
+        const fakeMatch = Object.assign(
+          [
+            text.slice(m.index, m.index + originalMatch[0].length),
+            originalMatch[1],
+          ] as unknown as RegExpExecArray,
+          { index: m.index, input: text, groups: undefined },
+        );
+        candidates.push({ index: m.index, kind, match: fakeMatch });
+      }
+    }
   }
 
   if (candidates.length === 0) return { kind: "text", content: text.trim() };
 
   candidates.sort((a, b) => a.index - b.index);
   const { kind, match } = candidates[0]!;
-  // Strip any leaked tool tags from preamble (e.g. model emits tag twice or mid-sentence)
+
+  // Strip any leaked tool tags from preamble text
   const before = text
     .slice(0, match.index)
     .replace(
@@ -626,7 +703,7 @@ export function parseResponse(text: string): ParsedResponse {
       "",
     )
     .trim();
-  const body = match[1]!.trim();
+  const body = (match[1] ?? "").trim();
 
   if (kind === "changes") {
     try {
@@ -690,7 +767,6 @@ export function parseResponse(text: string): ParsedResponse {
         glob: parsed.glob ?? "**/*",
       };
     } catch {
-      // treat body as plain pattern with no glob
       return { kind: "grep", content: before, pattern: body, glob: "**/*" };
     }
   }
@@ -788,6 +864,7 @@ export async function callChat(
   provider: Provider,
   systemPrompt: string,
   messages: Message[],
+  abortSignal?: AbortSignal,
 ): Promise<string> {
   const apiMessages = [...FEW_SHOT_MESSAGES, ...buildApiMessages(messages)];
 
@@ -825,6 +902,8 @@ export async function callChat(
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), 60_000);
 
+  abortSignal?.addEventListener("abort", () => controller.abort());
+
   const res = await fetch(url, {
     method: "POST",
     headers,
@@ -1251,7 +1330,7 @@ export function readFolder(folderPath: string, repoPath: string): string {
     const subfolders: string[] = [];
 
     for (const entry of entries) {
-      if (entry.startsWith(".") && entry !== ".env") continue; // skip hidden except .env hint
+      if (entry.startsWith(".") && entry !== ".env") continue;
       const full = path.join(candidate, entry);
       try {
         if (statSync(full).isDirectory()) {
@@ -1297,29 +1376,22 @@ export function grepFiles(
   try {
     regex = new RegExp(pattern, "i");
   } catch {
-    // fall back to literal string match if pattern is not valid regex
     regex = new RegExp(pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "i");
   }
 
-  // Convert glob to a simple path prefix/suffix filter
-  // Supports patterns like: src/**/*.tsx, **/*.ts, src/utils/*
   const globToFilter = (g: string): ((rel: string) => boolean) => {
-    // strip leading **/
     const cleaned = g.replace(/^\*\*\//, "");
     const parts = cleaned.split("/");
     const ext = parts[parts.length - 1];
     const prefix = parts.slice(0, -1).join("/");
 
     return (rel: string) => {
-      // extension match (e.g. *.tsx)
       if (ext?.startsWith("*.")) {
-        const extSuffix = ext.slice(1); // e.g. .tsx
+        const extSuffix = ext.slice(1);
         if (!rel.endsWith(extSuffix)) return false;
       } else if (ext && !ext.includes("*")) {
-        // exact filename
         if (!rel.endsWith(ext)) return false;
       }
-      // prefix match
       if (prefix && !prefix.includes("*")) {
         if (!rel.startsWith(prefix)) return false;
       }
@@ -1452,7 +1524,6 @@ export function generatePdf(
     const dir = path.dirname(fullPath);
     if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
 
-    // Escape content for embedding in a Python string literal
     const escaped = content
       .replace(/\\/g, "\\\\")
       .replace(/"""/g, '\\"\\"\\"')
@@ -1512,7 +1583,6 @@ for line in raw.split("\\n"):
     elif s == "":
         story.append(Spacer(1, 6))
     else:
-        # handle **bold** inline
         import re
         s = re.sub(r"\\*\\*(.+?)\\*\\*", r"<b>\\1</b>", s)
         s = re.sub(r"\\*(.+?)\\*", r"<i>\\1</i>", s)

package/skills.json

@@ -1,7 +0,0 @@
-[
-  {
-    "id": "1773310757090-o6sri",
-    "name": "this is a skill",
-    "description": "this is a skill"
-  }
-]