miii-cli 0.3.0 → 0.3.2

package/README.md

@@ -1,6 +1,6 @@
-# 🚀 Miii CLI — High-Performance Local AI Coding Agent
+# Miii — The High-Performance Local AI Coding Agent
 
-**The definitive local AI coding agent for your terminal. Automate complex engineering workflows with total control, zero cloud, and zero Python overhead.**
+> **You're paying $200/month for an AI that reads your private code and sends it to a cloud server you don't control. There's a better way.**
 
 ![MIII Demo](mii-cli.gif)
 
@@ -9,87 +9,166 @@
 [![license](https://img.shields.io/npm/l/miii-cli)](LICENSE)
 [![node](https://img.shields.io/node/v/miii-cli)](https://nodejs.org)
 
-## 📊 How Miii Stacks Up
+---
 
-| Feature | **Miii** | Claude Code | Codex CLI | Aider |
-|---|---|---|---|---|
-| **Runs locally** | ✅ Ollama / any API | ❌ Cloud only | ❌ Cloud only | ✅ Local + cloud |
-| **Code stays private** | ✅ Never leaves machine | ❌ Sent to Anthropic | ❌ Sent to OpenAI | ⚠️ Depends on model |
-| **Cost** | 🆓 Free (your compute) | 💳 Pay per token | 💳 Pay per token | 🆓 Free (local) |
-| **Runtime** | ⚡ TypeScript — instant start | 🐍 Node (fast) | 🐍 Node | 🐢 Python |
-| **Deep Think mode** | ✅ Gather + synthesize | ❌ | ❌ | ❌ |
-| **Auto-test loop** | ✅ Jest / Vitest / Mocha | ⚠️ Manual | ❌ | ⚠️ Manual |
-| **Web search built-in** | ✅ Tavily | ❌ | ❌ | ❌ |
-| **Surgical patch edits** | ✅ `patch_file` | ✅ | ⚠️ | ✅ |
-| **Session memory** | ✅ Named, persistent | ✅ | ❌ | ⚠️ Basic |
-| **Skill / plugin system** | ✅ npm + `.md` skills | ⚠️ MCP only | ❌ | ❌ |
-| **Open source** | ✅ MIT | ❌ | ❌ | ✅ Apache 2.0 |
+**Miii is a fully autonomous coding agent that runs entirely on your machine.** It plans, edits files, runs your tests, searches the web, indexes your codebase semantically, and iterates until the job is done — all without a single byte of your code leaving your network.
 
-> ✅ = supported  |  ⚠️ = partial  |  ❌ = not supported
-
-## ⚡️ Quick Start
-
-Get up and running in 30 seconds:
+Zero subscription. Zero cloud dependency. Zero Python overhead. **176 KB total.** Just raw engineering horsepower in your terminal.
 
 ```bash
-ollama pull qwen2.5-coder:7b
-npm install -g miii-cli
-miii
+npm install -g miii-cli && miii
 ```
 
-## 🧠 Why Miii?
+---
+
+## Why Engineers Are Switching
+
+Claude Code is impressive. It's also a 50 MB binary that costs $200/month, requires an internet connection, and sends every line of your codebase to a server you don't own.
 
-Most AI coding tools are either heavy Python wrappers or expensive monthly subscriptions that send your code to the cloud. **miii is different.**
+**Miii does everything Claude Code does. It's 176 KB. It's free. It runs on your laptop.**
 
-- **Local-First & Private**: Runs on Ollama or any OpenAI-compatible API. Your code never leaves your machine, ensuring 100% privacy and security.
-- **Blazing Fast**: Built with TypeScript for near-instant startup. No heavy Python runtime overhead. Tiny footprint, massive power.
-- **Fully Autonomous**: Miii doesn't just suggest code; it acts as a junior engineer—editing files, running your test suite, and iterating until the bugs are gone.
-- **Deep Context Awareness**: Automatically analyzes git diffs and project architecture, eliminating the need for manual copy-pasting.
+GitHub Copilot streams your proprietary code to Microsoft. Aider is a Python monolith that takes longer to boot than to write a function. All of them charge you monthly for the privilege of being the product.
 
-## 🔥 Killer Features
+Miii flips the model. Your compute. Your data. Your rules.
 
-- **🛠 Precision Editing**: Using `patch_file`, miii makes surgical changes without rewriting entire files.
-- **🔄 Auto-Test Loop**: Miii runs your Jest/Vitest/Mocha tests after every edit. If it breaks, it fixes itself.
-- **🌐 Web Intelligence**: Integrated `web_search` and `web_extract` via Tavily for real-time documentation.
-- **🧠 Deep Think**: Two-phase research mode — gathers from files, git, and web first, then synthesizes a complete answer. Available as `/think <query>` or as a tool the LLM calls autonomously.
-- **📐 Planning Mode**: Use `/plan` to architect a solution before a single line of code is written.
-- **📂 Session Memory**: Every conversation is auto-named and persisted. Resume your work instantly with `miii --session feature-auth`.
-- **📦 Skill System**: Extend miii with npm skill plugins or custom `.md` files.
+---
 
-## 🧠 Deep Think
+## What Miii Actually Does
 
-Deep think is a two-phase research engine built into miii:
+This isn't a fancy autocomplete. Miii is a **full autonomous agent loop:**
 
-1. **Gather phase** — runs a constrained inner loop with read-only tools: `read_file`, `list_files`, `git_status`, `git_log`, `git_diff`, `web_search`, `web_extract`. Guardrails enforce a hard cap of 6 tool calls and 4 web calls. No file writes, no shell mutations.
-2. **Synthesize phase** — gathered findings feed into the main run loop for a complete, grounded answer.
+1. You describe a goal
+2. Miii reads your codebase, plans the changes, edits the files
+3. It runs your test suite automatically after every change
+4. If tests fail, it reads the error, fixes the code, re-runs
+5. It repeats until the work is done
 
-**Two ways to trigger:**
+No babysitting. No copy-pasting error messages. No broken half-edits.
+
+---
+
+## What a Session Looks Like
 
 ```
-/think how does the auth middleware handle token expiry?
-/think what does this codebase do and how is it structured?
-/think latest breaking changes in react 19
+> refactor the auth module to use JWT instead of sessions
+
+  ● Researching: refactor auth module to use JWT
+  ● Reading src/auth/session.ts
+  ● Reading src/middleware/auth.ts
+  ● Reading src/routes/login.ts
+
+  Planning: 3 file(s) to change
+
+  ● Editing src/auth/session.ts
+  ● Editing src/middleware/auth.ts
+  ● Editing src/routes/login.ts
+  ● Running tests
+
+  ─ refactor done — 3 file(s) processed
 ```
 
-The LLM can also call `deep_think` autonomously mid-conversation when it decides a question needs multi-source research before answering.
+No prompts asking which files to change. No copy-pasting error messages. Just: describe the goal, watch it work.
+
+---
 
-> Requires a Tavily key (`/tavily-key tvly-...`) for web calls. File/git research works without it.
+## Killer Features
 
-## ⌨️ Command Cheat Sheet
+**🔍 Semantic Codebase Indexing** *(new in v0.3.2)*
+Build a vector index of your entire codebase using local embeddings. Ask "where is the auth logic?" and Miii finds it by meaning, not keyword. No data leaves your machine.
+
+**🧠 Deep Think Engine**
+Before answering complex questions, Miii runs a constrained research phase — reading files, checking git history, searching the web — then synthesizes a grounded answer. Not a hallucination. A conclusion.
+
+**🌐 Real-Time Web Access**
+Tavily-powered web search and page extraction, built in. Ask about breaking changes in a library you just upgraded. Get an answer that's actually current.
+
+**🛠 Surgical File Editing**
+`patch_file` replaces exact strings in your files. No full rewrites. No formatting destruction. No token waste. Exactly the change, nothing more.
+
+**🔄 Self-Healing Test Loop**
+Miii runs `npm test` after every file change. If something breaks, it reads the failure trace and fixes it autonomously — up to 3 retries before surfacing the issue to you.
+
+**📂 Persistent Sessions**
+Pick up exactly where you left off. Named sessions mean your context, your history, and your goal survive terminal restarts.
+
+**📦 Skill System**
+Extend Miii with plain Markdown files or npm packages. Ship reusable agent behaviors as versioned packages your whole team can pull.
+
+---
+
+## The Numbers That Matter
+
+| | **Miii** | Claude Code | Aider |
+|---|:---:|:---:|:---:|
+| Monthly cost | **$0** | $20–200 | $0 |
+| Bundle size | **176 KB** | ~50 MB | ~200 MB |
+| Your code stays local | **✅** | ❌ | ⚠️ |
+| Startup time | **<100ms** | ~2s | ~4s |
+| Semantic codebase index | **✅** | ❌ | ❌ |
+| Deep research mode | **✅** | ❌ | ❌ |
+| Auto test loop | **✅** | ⚠️ | ⚠️ |
+| Works air-gapped | **✅** | ❌ | ❌ |
+| License | **MIT** | Proprietary | Apache 2.0 |
+
+---
+
+## Get Running in 60 Seconds
+
+```bash
+# 1. Start Ollama and pull a model
+ollama pull qwen2.5-coder:7b
+
+# 2. Install Miii
+npm install -g miii-cli
+
+# 3. Go to your project and start
+cd your-project
+miii
+```
+
+That's it. No API keys. No account. No sign-up form.
+
+---
+
+## Power Commands
 
 | Command | What it does |
 |---|---|
-| `/think <query>` | Deep research: gather from files + web, then synthesize answer |
-| `/refactor <goal>` | The powerhouse: plans, edits, and tests across your whole codebase |
-| `/git <sub>` | Instant git status, diffs, and automated commit messages |
-| `/plan` | Stop coding, start thinking (Structured Planning Mode) |
-| `/model <name>` | Swap LLMs on the fly |
-| `/tavily-key <key>` | Enable real-time web browsing |
-| `/sessions` | Travel back in time to previous coding sessions |
+| `/think <question>` | Deep research: reads files + web, then answers |
+| `/refactor <goal>` | Autonomous multi-file refactor with test validation |
+| `/index build` | Build semantic vector index of your codebase |
+| `/index search <query>` | Find code by meaning, not string match |
+| `/git review` | AI reviews your current diff for bugs and issues |
+| `/git commit <msg>` | Stage everything and commit in one shot |
+| `/plan <topic>` | Structured planning mode before you write a line |
+| `/model <name>` | Hot-swap your LLM mid-conversation |
+| `/session <name>` | Switch between named project sessions |
+| `@filename` | Inject any file directly into context |
+
+---
+
+## Semantic Codebase Indexing
+
+For large codebases, Miii can build and query a local vector index — no third-party APIs, no embeddings sent anywhere.
+
+```bash
+# Pull an embedding model (one time)
+ollama pull nomic-embed-text
+
+# Index your project
+/index build
+
+# The agent now calls search_codebase automatically
+# when it needs to find code by concept
+```
 
-## ⚙️ Configuration
+The agent calls `search_codebase` on its own when needed. You don't have to think about it.
 
-Customise your experience in `.miii.json` or `~/.config/miii/config.json`:
+---
+
+## Configuration
+
+Drop a `.miii.json` in your project root or `~/.config/miii/config.json` globally:
 
 ```json
 {
@@ -97,26 +176,36 @@ Customise your experience in `.miii.json` or `~/.config/miii/config.json`:
   "provider": "ollama",
   "baseUrl": "http://localhost:11434",
   "gitContext": true,
-  "tavilyApiKey": "tvly-..."
+  "tavilyApiKey": "tvly-...",
+  "embedModel": "nomic-embed-text"
 }
 ```
 
-## 🛠 Build from Source
+---
+
+## Build from Source
 
 ```bash
 git clone https://github.com/maruakshay/miii-cli
 cd miii-cli && npm install && npm run build && npm link
 ```
 
-## 🌟 Community & Philosophy
+---
+
+## The Bottom Line
+
+The AI coding tools you're paying for right now will raise their prices, change their terms, and keep reading your code. **Miii won't.** It's MIT licensed, runs locally, and gets better every time Ollama ships a new model.
+
+One engineer built a 176 KB tool that replaces a $200/month cloud product. That shouldn't be a surprise — it should be the baseline.
+
+If this saves you time or money, **star the repo**. It's the only metric that tells other engineers this is worth their attention.
+
+**[⭐ Star on GitHub](https://github.com/maruakshay/miii-cli)**
+
+> Built by [@maruakshay](https://github.com/maruakshay) — open to PRs, issues, and model recommendations.
 
-**Own your AI stack. Stop renting your intelligence. The future of coding is local.**
+---
 
-miii is built for the community. If this tool saves you hours of coding, help us grow:
-- 🌟 **Star the repo** on GitHub
-- 🐦 **Share on X**
-- 🤖 **Post on Reddit**
-- 💬 **Tell a fellow developer**
+## License
 
-## 📜 License
-MIT
+MIT — do whatever you want with it.

package/dist/init.js

@@ -9,7 +9,7 @@ import { execSync } from 'child_process';
 import { loadConfig } from './config.js';
 import { SkillLoader } from './skills/loader.js';
 import { InputBar } from './tui/InputBar.js';
-import { welcome, setInkInstance } from './tui/printer.js';
+import { welcome } from './tui/printer.js';
 import { ensureOllama } from './llm/ollama.js';
 const require = createRequire(import.meta.url);
 const UPDATE_CACHE = join(homedir(), '.config', 'miii', 'update-check.json');
@@ -90,7 +90,6 @@ export async function lazyInit() {
     // Print welcome banner to scrollback BEFORE Ink starts
     welcome(config.provider, config.model, process.cwd(), currentVersion, updateAvailable, linked);
     const sessionName = argv.session || `s-${Date.now()}`;
-    const { waitUntilExit, clear } = render(React.createElement(InputBar, { config, skills, cwd: process.cwd(), session: sessionName, version: currentVersion }), { exitOnCtrlC: false });
-    setInkInstance(clear);
+    const { waitUntilExit } = render(React.createElement(InputBar, { config, skills, cwd: process.cwd(), session: sessionName, version: currentVersion }), { exitOnCtrlC: false });
     await waitUntilExit();
 }

package/dist/sessions.js

@@ -44,10 +44,29 @@ export function loadSession(name) {
 }
 export function saveSession(name, messages) {
     ensureDir();
-    writeFileSync(join(SESSIONS_DIR, `${sanitizeName(name)}.json`), JSON.stringify(messages));
+    try {
+        writeFileSync(join(SESSIONS_DIR, `${sanitizeName(name)}.json`), JSON.stringify(messages));
+    }
+    catch { }
 }
 export function deleteSession(name) {
     const p = join(SESSIONS_DIR, `${sanitizeName(name)}.json`);
     if (existsSync(p))
         unlinkSync(p);
 }
+export function deleteAllSessions(exceptName) {
+    ensureDir();
+    const files = readdirSync(SESSIONS_DIR).filter(f => f.endsWith('.json'));
+    let count = 0;
+    for (const f of files) {
+        const name = f.replace('.json', '');
+        if (exceptName && name === exceptName)
+            continue;
+        try {
+            unlinkSync(join(SESSIONS_DIR, f));
+            count++;
+        }
+        catch { }
+    }
+    return count;
+}

package/dist/tasks/queue.js

@@ -12,6 +12,7 @@ export class MicroQueue {
         if (!this.heap.length)
             return undefined;
         const top = this.heap[0];
+        this.order.delete(top.id);
         const last = this.heap.pop();
         if (this.heap.length) {
             this.heap[0] = last;

package/dist/tui/InputBar.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState, useCallback, useRef, useMemo } from 'react';
+import { useState, useCallback, useRef, useMemo, useEffect } from 'react';
 import { Box, Text, useStdout } from 'ink';
 import { InputArea } from './components/InputArea.js';
 import { ModelPicker } from './components/ModelPicker.js';
@@ -8,7 +8,8 @@ import { tools } from '../tools/index.js';
 import { readFile } from '../files/ops.js';
 import { generateId } from '../types.js';
 import * as printer from './printer.js';
-import { loadSession, saveSession, listSessions, deleteSession } from '../sessions.js';
+import { toolArgSummary } from './printer.js';
+import { loadSession, saveSession, listSessions, deleteSession, deleteAllSessions } from '../sessions.js';
 import { MacroQueue, MicroQueue } from '../tasks/queue.js';
 import { TaskExecutor } from '../tasks/executor.js';
 import { fileEditContext } from '../tasks/compactor.js';
@@ -24,6 +25,7 @@ import { useSession } from './hooks/useSession.js';
 import { useModelPicker } from './hooks/useModelPicker.js';
 import { useRunLoop } from './hooks/useRunLoop.js';
 import { runDeepThink } from './deepThink.js';
+import { setInkInstance } from './printer.js';
 const gitRun = promisify(exec);
 function buildAtContext(text) {
     const refs = [...text.matchAll(/@([\w./\-]+)/g)];
@@ -40,9 +42,20 @@ function buildAtContext(text) {
     }
     return parts.length ? parts.join('\n\n') + '\n\n' : '';
 }
+function formatElapsed(ms) {
+    const s = Math.floor(ms / 1000);
+    if (s < 60)
+        return `${s}s`;
+    const m = Math.floor(s / 60);
+    const rem = s % 60;
+    return rem === 0 ? `${m}m` : `${m}m ${rem}s`;
+}
 export function InputBar({ config, skills, cwd, session, version }) {
-    const { stdout } = useStdout();
+    const { stdout, write: stdoutWrite } = useStdout();
     const cols = stdout.columns ?? 80;
+    useEffect(() => {
+        setInkInstance(stdoutWrite);
+    }, []);
     const phraseSeq = useMemo(() => Array.from({ length: 100 }, () => Math.floor(Math.random() * THINKING_PHRASES.length)), []);
     const [planningMode, setPlanningMode] = useState(false);
     const macroQueueRef = useRef(new MacroQueue());
@@ -61,7 +74,7 @@ export function InputBar({ config, skills, cwd, session, version }) {
         },
     }), [config]);
     const allTools = useMemo(() => [...tools, deepThinkTool], [deepThinkTool]);
-    const { status, setStatus, tick, currentTool, setCurrentTool, taskLabel, setTaskLabel, thinkingStartRef, runLoop, handleAbort, } = useRunLoop(config, currentModelRef, pushHistory, allTools, abortRef);
+    const { status, setStatus, tick, currentTool, setCurrentTool, taskLabel, setTaskLabel, thinkingStartRef, runLoop, handleAbort, permissionRequest, resolvePermission, } = useRunLoop(config, currentModelRef, pushHistory, allTools, abortRef);
     // ─── refactor ─────────────────────────────────────────────────────────────
     const runRefactor = useCallback(async (goal) => {
         printer.systemMsg(`refactor: ${goal}`);
@@ -444,7 +457,12 @@ export function InputBar({ config, skills, cwd, session, version }) {
             if (arg.startsWith('delete ')) {
                 const target = arg.slice(7).trim();
                 if (!target) {
-                    printer.systemMsg('usage: /session delete <name>');
+                    printer.systemMsg('usage: /session delete <name|all>');
+                    return;
+                }
+                if (target === 'all') {
+                    const count = deleteAllSessions(sessionNameRef.current);
+                    printer.systemMsg(`deleted ${count} session(s) — kept active: ${sessionNameRef.current}`);
                     return;
                 }
                 if (target === sessionNameRef.current) {
@@ -514,7 +532,7 @@ export function InputBar({ config, skills, cwd, session, version }) {
     }, [skills, runLoop, openPicker]);
     const skillList = skills.list();
     // ─── render ────────────────────────────────────────────────────────────────
-    return (_jsxs(Box, { flexDirection: "column", children: [pickerOpen ? (_jsxs(_Fragment, { children: [_jsx(ModelPicker, { models: pickerModels, current: currentModel, loading: pickerLoading, error: pickerError, pull: pullState, onSelect: handleModelSelect, onPull: handleModelPull, onClose: () => { setPickerOpen(false); } }), _jsx(Divider, { cols: cols })] })) : (status === 'thinking' || status === 'tool') ? (_jsxs(_Fragment, { children: [_jsx(Box, { flexDirection: "column", paddingX: 1, children: _jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { children: status === 'thinking'
-                                        ? _jsxs(_Fragment, { children: [_jsxs(Text, { color: "yellow", children: [SPARKLE[tick % SPARKLE.length], " "] }), _jsx(Text, { color: "gray", dimColor: true, italic: true, children: THINKING_PHRASES[phraseSeq[Math.floor(tick / 62) % phraseSeq.length]] })] })
-                                        : _jsxs(Text, { color: "yellow", dimColor: true, children: ["\u2699 running ", currentTool ?? 'tool', "\u2026"] }) }), _jsxs(Box, { gap: 2, children: [_jsxs(Text, { color: "gray", dimColor: true, children: [Math.floor((Date.now() - thinkingStartRef.current) / 1000), "s"] }), taskLabel && _jsx(Text, { color: "cyan", dimColor: true, children: taskLabel })] })] }) }), _jsx(Divider, { cols: cols })] })) : null, _jsx(InputArea, { status: status, skills: skillList, cwd: cwd, planningMode: planningMode, onSubmit: handleSubmit, onAbort: handleAbort })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [pickerOpen ? (_jsxs(_Fragment, { children: [_jsx(ModelPicker, { models: pickerModels, current: currentModel, loading: pickerLoading, error: pickerError, pull: pullState, onSelect: handleModelSelect, onPull: handleModelPull, onClose: () => { setPickerOpen(false); } }), _jsx(Divider, { cols: cols })] })) : permissionRequest ? (_jsxs(Box, { paddingX: 1, gap: 1, children: [_jsx(Text, { color: "yellow", children: "\u26A0" }), _jsx(Text, { color: "white", bold: true, children: permissionRequest.toolName }), _jsx(Text, { color: "gray", children: toolArgSummary(permissionRequest.args) })] })) : (status === 'thinking' || status === 'tool') ? (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsx(Box, { children: status === 'thinking'
+                            ? _jsxs(_Fragment, { children: [_jsxs(Text, { color: "yellow", children: [SPARKLE[tick % SPARKLE.length], " "] }), _jsx(Text, { color: "gray", dimColor: true, italic: true, children: THINKING_PHRASES[phraseSeq[Math.floor(tick / 62) % phraseSeq.length]] })] })
+                            : _jsxs(Text, { color: "yellow", dimColor: true, children: ["\u2699 running ", currentTool ?? 'tool', "\u2026"] }) }), _jsxs(Box, { gap: 2, children: [_jsx(Text, { color: "gray", dimColor: true, children: formatElapsed(Date.now() - thinkingStartRef.current) }), taskLabel && _jsx(Text, { color: "cyan", dimColor: true, children: taskLabel })] })] })) : null, _jsx(InputArea, { status: status, skills: skillList, cwd: cwd, planningMode: planningMode, permissionRequest: permissionRequest, onPermissionResponse: resolvePermission, onSubmit: handleSubmit, onAbort: handleAbort, history: historyRef.current.filter(m => m.role === 'user').map(m => m.content) })] }));
 }

package/dist/tui/components/InputArea.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState, useMemo, useRef } from 'react';
-import { Box, Text, useInput } from 'ink';
+import { Box, Text, useInput, useStdout } from 'ink';
 import { listFiles } from '../../files/ops.js';
 import { CommandPalette } from './CommandPalette.js';
 import { AtPicker } from './AtPicker.js';
@@ -32,18 +32,34 @@ const PLANNING_COMMANDS = [
     { ns: 'plan', name: 'review', description: 'review and critique the plan so far' },
     { ns: 'plan', name: 'done', description: 'exit planning mode' },
 ];
-const PASTE_MIN_LINES = 3;
-const PASTE_MIN_CHARS = 200;
-export function InputArea({ status, skills, cwd, planningMode, onSubmit, onAbort }) {
+const PASTE_MIN_CHARS = 120;
+function wordStartBefore(line, col) {
+    let i = col;
+    while (i > 0 && line[i - 1] === ' ')
+        i--;
+    while (i > 0 && line[i - 1] !== ' ')
+        i--;
+    return i;
+}
+function wordEndAfter(line, col) {
+    let i = col;
+    while (i < line.length && line[i] === ' ')
+        i++;
+    while (i < line.length && line[i] !== ' ')
+        i++;
+    return i;
+}
+export function InputArea({ status, skills, cwd, planningMode, permissionRequest, onPermissionResponse, onSubmit, onAbort, history = [] }) {
     const [lines, setLines] = useState(['']);
     const [cursor, setCursor] = useState({ row: 0, col: 0 });
     const [overlay, setOverlay] = useState('none');
     const [overlayIdx, setOverlayIdx] = useState(0);
     const [pasteLines, setPasteLines] = useState(0);
     const pasteRef = useRef(null);
+    const [historyIdx, setHistoryIdx] = useState(-1);
+    const savedInputRef = useRef('');
     const [files, setFiles] = useState([]);
     const filesLoadedRef = useRef(false);
-    // built-ins first, then loaded skills (deduplicated by name)
     const allCommands = useMemo(() => {
         const builtinNames = new Set(BUILTIN_COMMANDS.map(b => b.name));
         const userSkills = skills.filter(s => !builtinNames.has(s.name));
@@ -61,7 +77,7 @@ export function InputArea({ status, skills, cwd, planningMode, onSubmit, onAbort
             return '';
         const after = before.slice(atIdx + 1);
         if (after.includes(' '))
-            return ''; // space breaks @ ref
+            return '';
         return after;
     }, [lines, cursor]);
     const filteredCommands = useMemo(() => {
@@ -80,7 +96,9 @@ export function InputArea({ status, skills, cwd, planningMode, onSubmit, onAbort
             setTimeout(() => { try {
                 setFiles(listFiles(cwd, true));
             }
-            catch { } }, 0);
+            catch {
+                filesLoadedRef.current = false;
+            } }, 0);
             return [];
         }
         return files.filter(f => f.rel.toLowerCase().includes(atQuery.toLowerCase())).slice(0, 8);
@@ -93,6 +111,8 @@ export function InputArea({ status, skills, cwd, planningMode, onSubmit, onAbort
         setOverlayIdx(0);
         pasteRef.current = null;
         setPasteLines(0);
+        setHistoryIdx(-1);
+        savedInputRef.current = '';
     }
     function appendChar(ch) {
         setLines(prev => {
@@ -103,23 +123,45 @@ export function InputArea({ status, skills, cwd, planningMode, onSubmit, onAbort
         });
         setCursor(c => ({ ...c, col: c.col + ch.length }));
     }
-    function deleteChar() {
+    function insertNewline() {
         const { row, col } = cursor;
+        const before = lines[row].slice(0, col);
+        const after = lines[row].slice(col);
         setLines(prev => {
             const next = [...prev];
-            if (col > 0) {
-                next[row] = next[row].slice(0, col - 1) + next[row].slice(col);
-            }
-            else if (row > 0) {
-                const prevLen = next[row - 1].length;
-                next.splice(row - 1, 2, next[row - 1] + next[row]);
-                setCursor({ row: row - 1, col: prevLen });
-                return next;
-            }
+            next.splice(row, 1, before, after);
             return next;
         });
-        if (col > 0)
+        setCursor({ row: row + 1, col: 0 });
+    }
+    function deleteChar() {
+        const { row, col } = cursor;
+        if (col > 0) {
+            setLines(prev => {
+                const next = [...prev];
+                next[row] = next[row].slice(0, col - 1) + next[row].slice(col);
+                return next;
+            });
             setCursor(c => ({ ...c, col: c.col - 1 }));
+        }
+        else if (row > 0) {
+            const prevLen = lines[row - 1].length;
+            setLines(prev => {
+                const next = [...prev];
+                next.splice(row - 1, 2, next[row - 1] + next[row]);
+                return next;
+            });
+            setCursor({ row: row - 1, col: prevLen });
+        }
+    }
+    function recallHistory(idx) {
+        const entry = history[history.length - 1 - idx];
+        if (!entry)
+            return;
+        const recalled = entry.split('\n');
+        setLines(recalled);
+        setCursor({ row: 0, col: recalled[0].length });
+        setHistoryIdx(idx);
     }
     function selectCommand(skill) {
         const name = (skill.ns === 'default' || skill.ns === 'builtin')
@@ -148,7 +190,17 @@ export function InputArea({ status, skills, cwd, planningMode, onSubmit, onAbort
         setOverlayIdx(0);
     }
     useInput((input, key) => {
-        // ESC: close overlay, abort stream, or clear input
+        if (permissionRequest && onPermissionResponse) {
+            if (input === 'y' || input === 'Y') {
+                onPermissionResponse(true);
+                return;
+            }
+            if (input === 'n' || input === 'N' || key.escape) {
+                onPermissionResponse(false);
+                return;
+            }
+            return;
+        }
         if (key.escape) {
             if (overlay !== 'none') {
                 setOverlay('none');
@@ -162,7 +214,6 @@ export function InputArea({ status, skills, cwd, planningMode, onSubmit, onAbort
             clearInput();
             return;
         }
-        // Ctrl+C
         if (key.ctrl && input === 'c') {
             if (status !== 'idle') {
                 onAbort();
@@ -187,7 +238,6 @@ export function InputArea({ status, skills, cwd, planningMode, onSubmit, onAbort
             if (key.return) {
                 if (overlay === 'command') {
                     if (commandQuery.includes(' ')) {
-                        // has args — submit full text, don't pick from palette
                         const text = fullInput.trim();
                         if (text) {
                             clearInput();
@@ -203,7 +253,6 @@ export function InputArea({ status, skills, cwd, planningMode, onSubmit, onAbort
                 }
                 return;
             }
-            // backspace/typing falls through to normal handling below
         }
         if (key.return) {
             const typed = fullInput.trim();
@@ -217,6 +266,11 @@ export function InputArea({ status, skills, cwd, planningMode, onSubmit, onAbort
             }
             return;
         }
+        // Ctrl+J — insert newline without submitting
+        if (key.ctrl && input === 'j') {
+            insertNewline();
+            return;
+        }
         if (key.backspace || key.delete) {
             if (pasteRef.current) {
                 pasteRef.current = null;
@@ -224,7 +278,6 @@ export function InputArea({ status, skills, cwd, planningMode, onSubmit, onAbort
                 return;
             }
             deleteChar();
-            // Recompute overlay trigger for updated input
             const r = cursor.row;
             const col = cursor.col;
             const prospectiveLine = col > 0
@@ -237,18 +290,96 @@ export function InputArea({ status, skills, cwd, planningMode, onSubmit, onAbort
                 setOverlay('none');
             if (overlay === 'at') {
                 const before = prospectiveLine.slice(0, Math.max(0, col - 1));
-                const atIdx = before.lastIndexOf('@');
-                if (atIdx === -1)
+                if (before.lastIndexOf('@') === -1)
                     setOverlay('none');
             }
             return;
         }
+        // Ctrl chords
+        if (key.ctrl) {
+            const { row, col } = cursor;
+            const line = lines[row] ?? '';
+            if (input === 'a') {
+                setCursor(c => ({ ...c, col: 0 }));
+                return;
+            }
+            if (input === 'e') {
+                setCursor(c => ({ ...c, col: line.length }));
+                return;
+            }
+            if (input === 'w') {
+                if (col === 0)
+                    return;
+                const newCol = wordStartBefore(line, col);
+                setLines(prev => {
+                    const next = [...prev];
+                    next[row] = line.slice(0, newCol) + line.slice(col);
+                    return next;
+                });
+                setCursor(c => ({ ...c, col: newCol }));
+                return;
+            }
+            if (input === 'k') {
+                setLines(prev => {
+                    const next = [...prev];
+                    next[row] = line.slice(0, col);
+                    return next;
+                });
+                return;
+            }
+            if (input === 'u') {
+                setLines(prev => {
+                    const next = [...prev];
+                    next[row] = '';
+                    return next;
+                });
+                setCursor(c => ({ ...c, col: 0 }));
+                return;
+            }
+            if (key.leftArrow) {
+                setCursor(c => ({ ...c, col: wordStartBefore(line, col) }));
+                return;
+            }
+            if (key.rightArrow) {
+                setCursor(c => ({ ...c, col: wordEndAfter(line, col) }));
+                return;
+            }
+            return;
+        }
+        // Arrow keys
         if (key.upArrow && overlay === 'none') {
-            setCursor(c => ({ row: Math.max(0, c.row - 1), col: 0 }));
+            if (cursor.row > 0) {
+                setCursor(c => ({ row: c.row - 1, col: Math.min(c.col, lines[c.row - 1]?.length ?? 0) }));
+                return;
+            }
+            // history recall at top row
+            if (history.length > 0) {
+                const nextIdx = historyIdx + 1;
+                if (nextIdx < history.length) {
+                    if (historyIdx === -1)
+                        savedInputRef.current = fullInput;
+                    recallHistory(nextIdx);
+                }
+            }
             return;
         }
         if (key.downArrow && overlay === 'none') {
-            setCursor(c => ({ row: Math.min(lines.length - 1, c.row + 1), col: 0 }));
+            if (cursor.row < lines.length - 1) {
+                setCursor(c => ({ row: c.row + 1, col: Math.min(c.col, lines[c.row + 1]?.length ?? 0) }));
+                return;
+            }
+            // history forward at bottom row
+            if (historyIdx > 0) {
+                recallHistory(historyIdx - 1);
+            }
+            else if (historyIdx === 0) {
+                const saved = savedInputRef.current;
+                const restored = saved ? saved.split('\n') : [''];
+                setLines(restored);
+                setCursor({ row: 0, col: restored[0].length });
+                setHistoryIdx(-1);
+                savedInputRef.current = '';
+            }
             return;
         }
         if (key.leftArrow) {
@@ -259,15 +390,18 @@ export function InputArea({ status, skills, cwd, planningMode, onSubmit, onAbort
             setCursor(c => ({ ...c, col: Math.min(lines[c.row]?.length ?? 0, c.col + 1) }));
             return;
         }
-        if (input && !key.ctrl && !key.meta) {
-            // Detect paste: Ink delivers entire pasted chunk as one input string
-            const lineCount = input.split('\n').length;
-            if (input.length > 1 && (lineCount >= PASTE_MIN_LINES || input.length >= PASTE_MIN_CHARS)) {
+        if (input && !key.meta) {
+            // Detect paste
+            const hasNewline = input.includes('\n');
+            const lineCount = hasNewline ? input.split('\n').length : 1;
+            if (input.length > 1 && (hasNewline || input.length >= PASTE_MIN_CHARS)) {
                 pasteRef.current = input;
                 setPasteLines(lineCount);
                 return;
             }
-            // Compute prospective new input to decide overlay
+            // Exit history mode on any edit
+            if (historyIdx !== -1)
+                setHistoryIdx(-1);
             const r = cursor.row;
             const col = cursor.col;
             const prospectiveLine = lines[r].slice(0, col) + input + lines[r].slice(col);
@@ -275,11 +409,9 @@ export function InputArea({ status, skills, cwd, planningMode, onSubmit, onAbort
             prospectiveLines[r] = prospectiveLine;
             const prospective = prospectiveLines.join('\n');
             appendChar(input);
-            // Open/update overlays
             if (prospective.startsWith('/')) {
-                const q = prospective.slice(1);
-                if (q.includes(' ')) {
-                    setOverlay('none'); // typing args — close palette, let user type freely
+                if (prospective.slice(1).includes(' ')) {
+                    setOverlay('none');
                 }
                 else {
                     setOverlay('command');
@@ -295,22 +427,32 @@ export function InputArea({ status, skills, cwd, planningMode, onSubmit, onAbort
             }
         }
     });
+    const { stdout } = useStdout();
+    const cols = stdout.columns ?? 80;
     const isProcessing = status !== 'idle';
-    const borderColor = isProcessing ? 'yellow' : 'cyan';
-    const hint = isProcessing
-        ? 'esc to abort'
-        : pasteLines > 0
-            ? 'backspace removes paste  enter to send'
-            : overlay === 'command' && !commandQuery.includes(' ')
-                ? '↑↓ navigate  enter select  esc close'
-                : overlay === 'at'
-                    ? '↑↓ navigate  enter select  esc close'
-                    : planningMode
-                        ? '📋 planning mode  / suggestions  enter send  /plan:done to exit'
-                        : '@ file  / command  enter send  ctrl+c exit';
-    return (_jsxs(Box, { flexDirection: "column", children: [overlay === 'command' && (_jsx(CommandPalette, { skills: allCommands, query: commandQuery, idx: overlayIdx })), overlay === 'at' && (_jsx(AtPicker, { files: filteredFiles, query: atQuery, idx: overlayIdx })), _jsxs(Box, { borderStyle: "round", borderColor: borderColor, paddingX: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: borderColor, bold: true, children: '❯ ' }), _jsx(Box, { flexDirection: "column", flexGrow: 1, children: pasteLines > 0 ? (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: "cyan", children: "\u2398" }), _jsxs(Text, { color: "cyan", children: ["pasted ", pasteLines, " lines"] }), (lines.length > 1 || lines[0]) && (_jsx(Text, { color: "gray", dimColor: true, children: "+ typed text" }))] })) : lines.length === 1 && !lines[0] ? (_jsx(Text, { color: isActive ? 'white' : 'gray', dimColor: isProcessing, children: isActive ? '█' : 'processing...' })) : (lines.map((line, i) => (_jsx(Text, { wrap: "wrap", children: i === cursor.row
-                                        ? renderLineWithCursor(line, cursor.col, isActive)
-                                        : line }, i)))) })] }), _jsx(Text, { color: "gray", dimColor: true, children: hint })] })] }));
+    const promptColor = permissionRequest ? 'yellow' : isProcessing ? 'yellow' : 'green';
+    const inHistory = historyIdx !== -1;
+    const hint = permissionRequest
+        ? 'y approve · n deny'
+        : isProcessing
+            ? 'esc to interrupt'
+            : pasteLines > 0
+                ? 'backspace removes paste · enter to send'
+                : overlay === 'command' && !commandQuery.includes(' ')
+                    ? '↑↓ navigate · enter select · esc close'
+                    : overlay === 'at'
+                        ? '↑↓ navigate · enter select · esc close'
+                        : inHistory
+                            ? `history [${historyIdx + 1}/${history.length}] · ↑↓ navigate · enter to send · esc clear`
+                            : planningMode
+                                ? 'planning mode · / suggestions · enter send · /plan:done exit'
+                                : 'enter send · @ file · / cmd · ctrl+j newline · ↑ history';
+    const pastePreview = pasteRef.current
+        ? pasteRef.current.split('\n')[0].slice(0, cols - 6)
+        : '';
+    return (_jsxs(Box, { flexDirection: "column", children: [overlay === 'command' && (_jsx(CommandPalette, { skills: allCommands, query: commandQuery, idx: overlayIdx })), overlay === 'at' && (_jsx(AtPicker, { files: filteredFiles, query: atQuery, idx: overlayIdx })), _jsx(Text, { color: "gray", dimColor: true, children: '─'.repeat(Math.max(cols, 10)) }), _jsxs(Box, { paddingX: 1, children: [_jsx(Text, { color: promptColor, bold: true, children: '> ' }), _jsx(Box, { flexDirection: "column", flexGrow: 1, children: permissionRequest ? (_jsxs(Box, { gap: 2, children: [_jsx(Text, { color: "green", bold: true, children: "y  yes" }), _jsx(Text, { color: "red", bold: true, children: "n  no" })] })) : pasteLines > 0 ? (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: "cyan", children: "\u2398" }), _jsxs(Text, { color: "cyan", children: ["pasted ", pasteLines, " line", pasteLines !== 1 ? 's' : ''] }), (lines.length > 1 || lines[0]) && (_jsx(Text, { color: "gray", dimColor: true, children: "+ typed text" }))] }), pastePreview && (_jsxs(Text, { color: "gray", dimColor: true, children: ["  ", pastePreview, pasteRef.current.split('\n')[0].length > cols - 6 ? '…' : ''] }))] })) : lines.length === 1 && !lines[0] ? (isActive ? (_jsxs(Text, { children: [_jsx(Text, { color: "gray", dimColor: true, children: "How can I help you?  " }), _jsx(Text, { children: "\u2588" })] })) : (_jsx(Text, { color: "gray", dimColor: true, children: " " }))) : (lines.map((line, i) => (_jsx(Text, { wrap: "wrap", children: i === cursor.row
+                                ? renderLineWithCursor(line, cursor.col, isActive)
+                                : line }, i)))) })] }), _jsx(Text, { color: "gray", dimColor: true, children: '─ ' + hint + ' ' + '─'.repeat(Math.max(0, cols - hint.length - 3)) })] }));
 }
 function renderLineWithCursor(line, col, showCursor) {
     return line.slice(0, col) + (showCursor ? '█' : '') + line.slice(col);

package/dist/tui/deepThink.js

@@ -34,6 +34,7 @@ Guardrails:
             return;
         depth++;
         let fullText = '';
+        let chatError = null;
         await chat({
             provider: config.provider,
             model,
@@ -41,10 +42,13 @@ Guardrails:
             apiKey: config.apiKey,
             messages: msgs,
             signal,
+            onChunk() { },
             async onDone(text) { fullText = text; },
             onError(err) { if (err.name !== 'AbortError')
-                throw err; },
+                chatError = err; },
         });
+        if (chatError)
+            throw chatError;
         if (!fullText)
             return;
         const pending = [];

package/dist/tui/git-context.js

@@ -24,7 +24,8 @@ export async function buildGitContext(cwd, lastStatusRef) {
             if (code.includes('D'))
                 continue;
             const raw = line.slice(3).trim().replace(/^"|"$/g, '');
-            const rel = raw.includes(' -> ') ? raw.split(' -> ')[1] : raw;
+            const arrowIdx = raw.lastIndexOf(' -> ');
+            const rel = arrowIdx !== -1 ? raw.slice(arrowIdx + 4) : raw;
             if (!rel)
                 continue;
             try {

package/dist/tui/hooks/useRunLoop.js

@@ -7,16 +7,24 @@ import * as printer from '../printer.js';
 const MAX_TOOL_DEPTH = 6;
 const FILE_EDIT_TOOLS = new Set(['edit_file', 'create_file', 'patch_file', 'delete_file']);
 const SHOW_RESULT_TOOLS = new Set(['run_tests', 'git_commit']);
+const PERMISSION_TOOLS = new Set(['edit_file', 'patch_file', 'delete_file', 'create_file', 'move_file', 'run_command', 'git_commit']);
 export function useRunLoop(config, currentModelRef, pushHistory, extraTools = [], abortRef) {
     const [status, setStatus] = useState('idle');
     const [tick, setTick] = useState(0);
     const [currentTool, setCurrentTool] = useState();
     const [taskLabel, setTaskLabel] = useState();
+    const [permissionRequest, setPermissionRequest] = useState(null);
+    const permissionResolveRef = useRef(null);
     const thinkingStartRef = useRef(0);
     const extraToolsRef = useRef(extraTools);
     extraToolsRef.current = extraTools;
     const pushHistoryRef = useRef(pushHistory);
     useEffect(() => { pushHistoryRef.current = pushHistory; }, [pushHistory]);
+    const resolvePermission = useCallback((approved) => {
+        permissionResolveRef.current?.(approved);
+        permissionResolveRef.current = null;
+        setPermissionRequest(null);
+    }, []);
     useEffect(() => {
         if (status === 'idle')
             return;
@@ -25,6 +33,7 @@ export function useRunLoop(config, currentModelRef, pushHistory, extraTools = []
     }, [status]);
     const runLoop = useCallback(async (contextMsgs, depth = 0, goal) => {
         if (depth >= MAX_TOOL_DEPTH) {
+            abortRef.current = null;
             setStatus('idle');
             return;
         }
@@ -78,6 +87,17 @@ export function useRunLoop(config, currentModelRef, pushHistory, extraTools = []
                         const allTools = [...staticTools, ...extraToolsRef.current];
                         const tool = allTools.find(t => t.name === tc.name);
                         setCurrentTool(tc.name);
+                        if (PERMISSION_TOOLS.has(tc.name)) {
+                            const approved = await new Promise(resolve => {
+                                permissionResolveRef.current = resolve;
+                                setPermissionRequest({ toolName: tc.name, args: tc.args });
+                            });
+                            if (!approved) {
+                                printer.systemMsg(`denied: ${tc.name}`);
+                                next.push({ role: 'user', content: `Tool ${tc.name} was denied by the user` });
+                                break;
+                            }
+                        }
                         if (tool) {
                             try {
                                 printer.toolCallStart(tc.name, tc.args);
@@ -136,6 +156,11 @@ export function useRunLoop(config, currentModelRef, pushHistory, extraTools = []
     }, [config]);
     const handleAbort = useCallback(() => {
         abortRef.current?.abort();
+        if (permissionResolveRef.current) {
+            permissionResolveRef.current(false);
+            permissionResolveRef.current = null;
+            setPermissionRequest(null);
+        }
         setStatus('idle');
     }, []);
     return {
@@ -144,5 +169,6 @@ export function useRunLoop(config, currentModelRef, pushHistory, extraTools = []
         taskLabel, setTaskLabel,
         thinkingStartRef,
         runLoop, handleAbort,
+        permissionRequest, resolvePermission,
     };
 }

package/dist/tui/printer.js

@@ -1,11 +1,15 @@
 // ANSI-formatted stdout output — goes into terminal scrollback
-let _inkClear = null;
-export function setInkInstance(clear) {
-    _inkClear = clear;
+let _inkWrite = null;
+export function setInkInstance(inkWrite) {
+    _inkWrite = inkWrite;
 }
 function write(s) {
-    _inkClear?.();
-    process.stdout.write(s);
+    if (_inkWrite) {
+        _inkWrite(s);
+    }
+    else {
+        process.stdout.write(s);
+    }
 }
 const R = '\x1b[0m';
 const BOLD = '\x1b[1m';
@@ -63,7 +67,7 @@ function formatContent(text) {
 function truncate(s, n) {
     return s.length > n ? s.slice(0, n) + '…' : s;
 }
-function toolArgSummary(args) {
+export function toolArgSummary(args) {
     if (args.message)
         return `"${truncate(String(args.message), 60)}"`;
     if (args.path)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miii-cli",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "description": "The high-performance local AI coding agent for your terminal. Automate complex workflows with local LLMs.",
   "license": "MIT",