ikie-cli 0.1.5 → 0.1.7

package/dist/agent.js

@@ -47,6 +47,11 @@ function toolPhaseLabel(name) {
         case 'list_dir': return 'Listing directory';
         case 'search_files': return 'Searching';
         case 'grep': return 'Searching';
+        case 'git_status': return 'Git status';
+        case 'git_diff': return 'Git diff';
+        case 'git_log': return 'Git log';
+        case 'git_commit': return 'Committing';
+        case 'git_branch': return 'Git branch';
         case 'fetch_url': return 'Fetching';
         case 'web_search': return 'Searching web';
         default: return `Preparing ${name}`;
@@ -717,11 +722,28 @@ changes they didn't ask for.
 - \`search_files\`: Find files by glob pattern
 - \`grep\`: Search file contents by regex
 - \`memory_write\`: Persist important notes across sessions
+- \`git_status\`: Show working tree status (staged, unstaged, untracked files)
+- \`git_diff\`: Show file diffs — use staged:true for what's ready to commit
+- \`git_log\`: Show recent commit history
+- \`git_commit\`: Stage files and create a commit (stages all changes by default)
+- \`git_branch\`: List branches or create a new one (checkout:true to switch immediately)
 - \`fetch_url\`: Fetch a web page or URL and return its readable text (HTML is stripped to plain text).
   Use it to read docs, articles, or API responses when you have a URL.
 - \`web_search\`: Search the web for a query and get back titles, URLs, and snippets. Works
   automatically for logged-in ikie users — no separate API key needed. Combine with \`fetch_url\`
   to read a promising result in full.
+
+## Using web_search correctly
+- **Always search when the user asks about anything current** — versions, prices, news, docs,
+  release dates. Never answer from memory alone for time-sensitive facts.
+- **Check dates in snippets.** Results are ordered by relevance, not recency. If snippets show
+  conflicting versions or dates, fetch the most promising URL to get the ground truth.
+- **For "latest X" queries**, include the current year in your search (e.g. "latest Node.js version 2026")
+  to surface recent results over older cached pages.
+- **If a fetch returns 403/blocked**, try a different URL from the search results — don't give up.
+- **Trust fetched page content over snippet summaries** — snippets can be stale; the live page is authoritative.
+- **Never state a version, date, or fact as definitive if your search results conflict** — say what
+  the most recent source says and link it.
 - \`ask_user\`: Ask the user a clarifying question when you need more info to proceed.
   The user's answer is returned as the tool result. Use sparingly — only when genuinely
   unsure. Don't ask for confirmation on safe operations.

package/dist/repl.js

@@ -1,5 +1,5 @@
 import * as readline from 'node:readline';
-import { execSync } from 'child_process';
+import { execSync, exec } from 'child_process';
 import { restoreStdinListeners } from './agent.js';
 import { c, PROMPT, CONTINUE_PROMPT, printPromptHeader, modeTag, drawBanner, infoLine, successLine, errorLine, THEMES, setTheme, stripAnsi, } from './theme.js';
 import { renderMarkdown } from './renderer.js';
@@ -782,6 +782,18 @@ function selectThemeInteractively(rl, config) {
         prompt();
     });
 }
+// Notify the user when a long task finishes (> 10s). Terminal bell always;
+// OS notification best-effort depending on platform.
+function notify(message) {
+    process.stdout.write('\x07');
+    const safe = message.replace(/"/g, "'");
+    if (process.platform === 'darwin') {
+        exec(`osascript -e 'display notification "${safe}" with title "ikie"'`, () => { });
+    }
+    else if (process.platform === 'linux') {
+        exec(`notify-send "ikie" "${safe}" 2>/dev/null`, () => { });
+    }
+}
 export async function startREPL(agent, config, projectContext, oneShot) {
     void HISTORY_FILE;
     // A `/`-prefixed launch arg (e.g. `ikie /session load foo`) is a slash
@@ -1099,6 +1111,10 @@ export async function startREPL(agent, config, projectContext, oneShot) {
             // TTY doesn't also echo input — otherwise every line is echoed twice.
             if (process.stdin.isTTY)
                 process.stdin.setRawMode(true);
+            const elapsedMs = Date.now() - taskStartedAt;
+            if (elapsedMs > 10000 && !abortController.signal.aborted && !taskFailed) {
+                notify(`Done in ${elapsed}`);
+            }
             const status = abortController.signal.aborted
                 ? c.warning(formatTaskTimeline(agent, elapsed, 'cancelled'))
                 : taskFailed

package/dist/tools.js

@@ -167,6 +167,79 @@ export const TOOL_DEFS = [
             },
         },
     },
+    {
+        type: 'function',
+        function: {
+            name: 'git_status',
+            description: 'Show the working tree status (staged, unstaged, untracked files).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string', description: 'Repository path (default: cwd)' },
+                },
+                required: [],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'git_diff',
+            description: 'Show file diffs. Use staged:true for what is staged for commit.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    staged: { type: 'boolean', description: 'Show staged diff (default: unstaged)' },
+                    path: { type: 'string', description: 'Limit diff to this file or directory' },
+                },
+                required: [],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'git_log',
+            description: 'Show recent commit history.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    limit: { type: 'number', description: 'Number of commits to show (default 10)' },
+                },
+                required: [],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'git_commit',
+            description: 'Stage files and create a commit. Stages all changes by default, or specific files if provided.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    message: { type: 'string', description: 'Commit message' },
+                    files: { type: 'array', items: { type: 'string' }, description: 'Files to stage (default: all changed files)' },
+                },
+                required: ['message'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'git_branch',
+            description: 'List branches, or create a new branch. Set checkout:true to switch to it immediately.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Branch name to create. Omit to list branches.' },
+                    checkout: { type: 'boolean', description: 'Switch to the new branch after creating it' },
+                },
+                required: [],
+            },
+        },
+    },
     {
         type: 'function',
         function: {
@@ -201,11 +274,11 @@ export const TOOL_DEFS = [
 // ─── Safe tools (auto-approved) ───────────────────────────────────────────────
 // spawn_agent is "safe" at the dispatch layer — the tools the sub-agent itself
 // runs go through their own approval inside the sub-agent loop.
-export const SAFE_TOOLS = new Set(['read_file', 'list_dir', 'search_files', 'grep', 'memory_write', 'spawn_agent', 'ask_user', 'fetch_url', 'web_search']);
+export const SAFE_TOOLS = new Set(['read_file', 'list_dir', 'search_files', 'grep', 'memory_write', 'spawn_agent', 'ask_user', 'fetch_url', 'web_search', 'git_status', 'git_diff', 'git_log', 'git_branch']);
 // Tools available in PLAN mode — read-only exploration plus delegation/questions.
 // Everything that mutates the filesystem or runs commands (write_file, edit_file,
 // bash, memory_write) is intentionally excluded so plan mode can only research.
-export const PLAN_TOOLS = new Set(['read_file', 'list_dir', 'search_files', 'grep', 'spawn_agent', 'ask_user', 'fetch_url', 'web_search']);
+export const PLAN_TOOLS = new Set(['read_file', 'list_dir', 'search_files', 'grep', 'spawn_agent', 'ask_user', 'fetch_url', 'web_search', 'git_status', 'git_diff', 'git_log', 'git_branch']);
 // ─── Display helpers ──────────────────────────────────────────────────────────
 export function formatToolArgs(name, input) {
     const p = (v) => v != null && v !== 'undefined' ? String(v) : '(missing)';
@@ -236,6 +309,18 @@ export function formatToolArgs(name, input) {
             const task = String(input.task ?? '');
             return `"${task.length > 56 ? task.slice(0, 56) + '…' : task}"`;
         }
+        case 'git_status':
+            return input.path ? `"${p(input.path)}"` : '(cwd)';
+        case 'git_diff':
+            return `${input.staged ? 'staged' : 'unstaged'}${input.path ? ` "${p(input.path)}"` : ''}`;
+        case 'git_log':
+            return `last ${input.limit ?? 10}`;
+        case 'git_commit': {
+            const msg = String(input.message ?? '');
+            return `"${msg.length > 56 ? msg.slice(0, 56) + '…' : msg}"`;
+        }
+        case 'git_branch':
+            return input.name ? `"${p(input.name)}"${input.checkout ? ' --checkout' : ''}` : '(list)';
         case 'fetch_url':
             return `"${p(input.url)}"`;
         case 'web_search': {
@@ -506,6 +591,84 @@ async function memoryWrite(input) {
         return `Error saving to ${scope} memory: ${msg}`;
     }
 }
+// ─── Git ──────────────────────────────────────────────────────────────────────
+async function gitStatus(input) {
+    const cwd = input.path ? resolve(input.path) : process.cwd();
+    try {
+        const { stdout } = await execAsync('git status', { cwd });
+        return stdout.trim() || '(nothing to show)';
+    }
+    catch (err) {
+        const e = err;
+        return `Error: ${e.stderr?.trim() ?? e.message ?? err}`;
+    }
+}
+async function gitDiff(input) {
+    const cwd = process.cwd();
+    const stagedFlag = input.staged ? '--staged' : '';
+    const pathArg = input.path ? `-- "${input.path}"` : '';
+    try {
+        const { stdout } = await execAsync(`git diff ${stagedFlag} ${pathArg}`.trim(), { cwd, maxBuffer: 2 * 1024 * 1024 });
+        return stdout.trim() || '(no diff)';
+    }
+    catch (err) {
+        const e = err;
+        return `Error: ${e.stderr?.trim() ?? e.message ?? err}`;
+    }
+}
+async function gitLog(input) {
+    const limit = Math.min(input.limit ?? 10, 100);
+    try {
+        const { stdout } = await execAsync(`git log --oneline --decorate -${limit}`, { cwd: process.cwd() });
+        return stdout.trim() || '(no commits)';
+    }
+    catch (err) {
+        const e = err;
+        return `Error: ${e.stderr?.trim() ?? e.message ?? err}`;
+    }
+}
+async function gitCommit(input) {
+    const msg = (input.message ?? '').trim();
+    if (!msg)
+        return 'Error: message is required for git_commit';
+    const cwd = process.cwd();
+    try {
+        const addTarget = input.files?.length
+            ? input.files.map(f => `"${f}"`).join(' ')
+            : '-A';
+        await execAsync(`git add ${addTarget}`, { cwd });
+        const { stdout } = await execAsync(`git commit -m ${JSON.stringify(msg)}`, { cwd });
+        return stdout.trim();
+    }
+    catch (err) {
+        const e = err;
+        const parts = [];
+        if (e.stdout?.trim())
+            parts.push(e.stdout.trim());
+        if (e.stderr?.trim())
+            parts.push(e.stderr.trim());
+        return `Error: ${parts.join('\n') || (e.message ?? String(err))}`;
+    }
+}
+async function gitBranch(input) {
+    const cwd = process.cwd();
+    try {
+        if (!input.name) {
+            const { stdout } = await execAsync('git branch -a', { cwd });
+            return stdout.trim() || '(no branches)';
+        }
+        if (input.checkout) {
+            const { stdout, stderr } = await execAsync(`git checkout -b "${input.name}"`, { cwd });
+            return (stdout + stderr).trim() || `Switched to new branch '${input.name}'`;
+        }
+        await execAsync(`git branch "${input.name}"`, { cwd });
+        return `Created branch '${input.name}'`;
+    }
+    catch (err) {
+        const e = err;
+        return `Error: ${e.stderr?.trim() ?? e.message ?? err}`;
+    }
+}
 // ─── Web ──────────────────────────────────────────────────────────────────────
 function htmlToText(html) {
     return html
@@ -623,6 +786,11 @@ export async function executeTool(name, input) {
         case 'search_files': return searchFiles(input);
         case 'grep': return grepFiles(input);
         case 'memory_write': return memoryWrite(input);
+        case 'git_status': return gitStatus(input);
+        case 'git_diff': return gitDiff(input);
+        case 'git_log': return gitLog(input);
+        case 'git_commit': return gitCommit(input);
+        case 'git_branch': return gitBranch(input);
         case 'fetch_url': return fetchUrl(input);
         case 'web_search': return webSearch(input);
         default: return `Unknown tool: ${name}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ikie-cli",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Agentic coding CLI — your terminal AI pair programmer",
   "type": "module",
   "bin": {