miii-agent 0.1.0 → 0.1.4

package/README.md

@@ -1,8 +1,123 @@
 # miii
 
-The local-first AI coding agent for engineers who hate latency.
+> Your code never leaves your machine. No API keys. No cloud. No bullshit.
 
-miii transforms your terminal into a high-performance development environment by pairing a tight Ink TUI with Ollama. It is a zero-config, private companion that can read your code, write your features, and run your tests—all without a single byte leaving your machine.
+**miii** is a local-first AI coding agent that lives in your terminal. Powered by [Ollama](https://ollama.com), it reads your code, writes features, runs tests, and fixes bugs — entirely on your hardware, at native speed.
+
+[![npm](https://img.shields.io/npm/v/miii-agent)](https://www.npmjs.com/package/miii-agent)
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![node](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
+
+---
+
+## Demo
+
+![miii demo](demo.gif)
+
+---
+
+## Why miii?
+
+Most AI coding tools are wrappers around cloud APIs. They're slow, expensive, and send your private code to someone else's server.
+
+miii is different:
+
+- **Local-first** — Powered by Ollama. Your code stays on your disk, period.
+- **Zero ceremony** — No API keys. No billing. No accounts. Just `miii`.
+- **Actually agentic** — miii doesn't just chat. It decomposes problems, calls tools, and verifies results like an engineer would.
+- **Fast** — No network round-trips. Response time is limited by your GPU, not a CDN.
+
+---
+
+## Installation
+
+### Prerequisites
+
+- **Node.js** ≥ 18
+- **Ollama** running locally — [install here](https://ollama.com/download)
+- A coding model pulled locally:
+
+```bash
+ollama pull qwen2.5-coder:14b
+# or any model you prefer
+ollama pull deepseek-coder-v2
+```
+
+### Install miii
+
+```bash
+npm install -g miii-agent
+```
+
+### Launch
+
+```bash
+miii
+```
+
+That's it.
+
+---
+
+## Usage
+
+Once inside the TUI, just type naturally:
+
+```
+> refactor the auth module to use async/await
+> @src/server.ts add rate limiting to all POST routes
+> why are my tests failing in utils/parser.ts
+```
+
+### Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `Enter` | Send prompt |
+| `@filename` | Attach file to context |
+| `/models` | Switch active Ollama model |
+| `/clear` | Reset conversation history |
+| `Esc` | Stop current generation or tool run |
+| `Ctrl+C` | Quit |
+
+---
+
+## Configuration
+
+Settings live in `~/.miii/config.json` and are created on first run.
+
+```json
+{
+  "model": "qwen2.5-coder:14b",
+  "ollamaHost": "http://localhost:11434",
+  "effort": "medium"
+}
+```
+
+| Field | Description | Values |
+|-------|-------------|--------|
+| `model` | Default Ollama model | any `ollama list` model |
+| `ollamaHost` | Ollama API endpoint | URL string |
+| `effort` | Controls temperature & limits | `low` \| `medium` \| `high` |
+
+---
+
+## Capabilities
+
+miii ships with a built-in tool suite the agent can invoke autonomously:
+
+| Tool | What it does |
+|------|-------------|
+| `read_file` | Read any file in your workspace |
+| `write_file` | Create new files |
+| `edit_file` | Precise string-level edits (no rewrites) |
+| `glob` | Pattern-match files across the project |
+| `grep` | Regex search across files |
+| `run_bash` | Execute shell commands |
+
+Every sensitive operation is gated by a permission system — you approve what the agent can touch.
+
+---
 
 ## Architecture
 
@@ -49,65 +164,36 @@ graph TD
     App -.->|"reads"| Config
 ```
 
-## The Philosophy
-
-Most AI agents are wrappers around cloud APIs. They are slow, expensive, and a privacy nightmare. miii is different:
-
-1. Local-First: Powered by Ollama. Your code stays on your disk.
-2. Zero Ceremony: No API keys. No billing. Just run miii and start coding.
-3. Engineering Mindset: miii doesn't just "chat". It treats every request as a bug, feature, or fix. It decomposes problems, executes tools, and verifies results.
-
-## Project Status
-
-This project is currently an MVP designed to demonstrate and refine basic AI coding skills. I am refurbishing older implementations and experimenting with the agent loop. Feel free to fork, modify, or do whatever you want with this codebase.
-
-
-## Capabilities
-
-miii is equipped with a suite of tools to interact with your workspace:
-
-- File System: read_file, write_file, edit_file (precise string replacement).
-- Discovery: glob (pattern matching), grep (regex search).
-- Execution: run_bash (shell command execution).
-
-Every sensitive operation is gated by a permission system. You decide what the agent can touch.
+---
 
-## Quick Start
-
-### 1. Prerequisites
-- Node.js 18+
-- Ollama (running locally via ollama serve)
-- A coder model (e.g., ollama pull qwen2.5-coder:14b)
+## Development
 
-### 2. Install
-npm i -g miii-cli
+```bash
+git clone https://github.com/maruakshay/miii-cli.git
+cd miii-cli
+npm install
+npm run dev
+```
 
-### 3. Launch
-miii
+```bash
+npm run build   # production build
+npm run start   # run built output
+```
 
-## TUI Cheat Sheet
+---
 
-- Type & Enter: Send a prompt to the agent.
-- @file: Inline a file's content into the context.
-- /models: Switch your active Ollama model.
-- /clear: Reset conversation history.
-- Esc: Stop the current generation or tool execution.
-- Ctrl+C: Quit.
+## Project Status
 
-## Configuration
+MVP. Core agent loop works. Actively refining tool execution, streaming, and the permission model. PRs welcome — fork it, break it, improve it.
 
-Global settings are stored in ~/.miii/config.json:
-- model: Your default LLM.
-- ollamaHost: Your Ollama API endpoint.
-- effort: Tuning for temperature and limits (low | medium | high).
+---
 
+## License
 
-## Development
+MIT © [maruakshay](https://github.com/maruakshay)
 
-git clone https://github.com/maruakshay/miii-cli.git
-cd miii-cli
-npm install
-npm run dev
+---
 
-## License
-MIT
+<p align="center">
+  Built for engineers who'd rather own their tools than rent them.
+</p>

package/dist/cli.js

@@ -195,8 +195,8 @@ function ModelList({ models, cursor, activeModel, showActive }) {
       "<model>"
     ] });
   }
-  return /* @__PURE__ */ jsx2(Box2, { flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: models.map((m, i) => /* @__PURE__ */ jsxs2(Text2, { color: i === cursor ? "white" : void 0, dimColor: i !== cursor, children: [
-    i === cursor ? "\u25B6 " : "  ",
+  return /* @__PURE__ */ jsx2(Box2, { flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: models.map((m, i) => /* @__PURE__ */ jsxs2(Text2, { color: i === cursor ? "blue" : void 0, dimColor: i !== cursor, children: [
+    i === cursor ? "\u276F " : "  ",
     m,
     showActive && m === activeModel ? /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: "  (active)" }) : null
   ] }, m)) });
@@ -281,16 +281,19 @@ function CommandPalette({ filter, cursor }) {
     Box5,
     {
       flexDirection: "column",
-      borderStyle: "single",
-      borderColor: "white dim",
+      borderStyle: "round",
+      borderColor: "gray",
       marginX: 1,
       marginBottom: 0,
       paddingX: 1,
       children: [
         filtered.map((cmd, i) => {
           const active = i === cursor;
-          return /* @__PURE__ */ jsxs5(Box5, { gap: 2, children: [
-            /* @__PURE__ */ jsx5(Text5, { bold: active, color: active ? "white" : void 0, dimColor: !active, children: cmd.name }),
+          return /* @__PURE__ */ jsxs5(Box5, { gap: 1, children: [
+            /* @__PURE__ */ jsxs5(Text5, { bold: active, color: active ? "blue" : void 0, dimColor: !active, children: [
+              active ? "\u276F " : "  ",
+              cmd.name
+            ] }),
             /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: cmd.description })
           ] }, cmd.name);
         }),
@@ -364,16 +367,16 @@ function FilePicker({ matches, cursor }) {
     Box6,
     {
       flexDirection: "column",
-      borderStyle: "single",
-      borderColor: "white dim",
+      borderStyle: "round",
+      borderColor: "gray",
       marginX: 1,
       marginBottom: 0,
       paddingX: 1,
       children: [
         matches.map((f, i) => {
           const active = i === cursor;
-          return /* @__PURE__ */ jsx6(Box6, { children: /* @__PURE__ */ jsxs6(Text6, { bold: active, color: active ? "white" : void 0, dimColor: !active, children: [
-            active ? "\u203A " : "  ",
+          return /* @__PURE__ */ jsx6(Box6, { children: /* @__PURE__ */ jsxs6(Text6, { bold: active, color: active ? "blue" : void 0, dimColor: !active, children: [
+            active ? "\u276F " : "  ",
             f
           ] }) }, f);
         }),
@@ -432,6 +435,14 @@ function ThinkingBlock({ content }) {
   ] });
 }
 
+// src/ui/constants.ts
+var EMPTY_STATE_HINTS = [
+  "\u2022 explain @file \u2014 reference a file with @",
+  "\u2022 /models \u2014 switch model or effort",
+  "\u2022 ctrl+t \u2014 toggle thinking \xB7 esc \u2014 cancel"
+];
+var EMPTY_STATE_TITLE = "Ask anything, or try:";
+
 // src/ui/ChatView.tsx
 import { jsx as jsx8, jsxs as jsxs8 } from "react/jsx-runtime";
 function formatTokens(n) {
@@ -642,16 +653,17 @@ function summarizeInput(input) {
   return "";
 }
 function PermissionPrompt({ req, cursor }) {
+  const label = TOOL_LABEL[req.toolName] ?? req.toolName;
   const options = [
     { label: "Yes", key: "yes" },
-    { label: "No, and tell me what to do differently", key: "no" }
+    { label: "No", key: "no" }
   ];
   const summary = summarizeInput(req.input);
   return /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", marginBottom: 1, borderStyle: "round", borderColor: "blue", paddingX: 1, children: [
     /* @__PURE__ */ jsx8(Text8, { color: "blue", bold: true, children: "Tool use" }),
     /* @__PURE__ */ jsx8(Box8, { marginTop: 1, children: /* @__PURE__ */ jsxs8(Text8, { children: [
       "Allow ",
-      /* @__PURE__ */ jsx8(Text8, { bold: true, children: req.toolName }),
+      /* @__PURE__ */ jsx8(Text8, { bold: true, children: label }),
       "?"
     ] }) }),
     summary && /* @__PURE__ */ jsx8(Box8, { marginLeft: 2, children: /* @__PURE__ */ jsx8(Text8, { dimColor: true, children: summary }) }),
@@ -675,7 +687,15 @@ function ChatView({
   activeToolUses,
   activeToolResults
 }) {
+  const empty = messages.length === 0 && !streaming && !thinking && !pendingPermission && !error;
   return /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", marginLeft: 1, marginBottom: 1, children: [
+    empty && /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", marginBottom: 1, children: [
+      /* @__PURE__ */ jsx8(Text8, { dimColor: true, children: EMPTY_STATE_TITLE }),
+      EMPTY_STATE_HINTS.map((h, i) => /* @__PURE__ */ jsxs8(Text8, { dimColor: true, children: [
+        "  ",
+        h
+      ] }, i))
+    ] }),
     messages.map(
       (msg, i) => msg.role === "user" ? /* @__PURE__ */ jsxs8(Box8, { flexDirection: "row", marginBottom: 1, children: [
         /* @__PURE__ */ jsx8(Text8, { color: "blue", children: "\u25CF " }),
@@ -1726,6 +1746,41 @@ function useKeyboard(opts) {
   });
 }
 
+// src/updateCheck.ts
+import { createRequire } from "module";
+var require2 = createRequire(import.meta.url);
+var PKG_NAME = "miii-agent";
+function currentVersion() {
+  try {
+    return require2("../package.json").version;
+  } catch {
+    return "";
+  }
+}
+function newerVersion(current, latest) {
+  const parse = (v) => v.replace(/^v/, "").split(".").map(Number);
+  const [ca, cb, cc] = parse(current);
+  const [la, lb, lc] = parse(latest);
+  if (la !== ca) return la > ca;
+  if (lb !== cb) return lb > cb;
+  return lc > cc;
+}
+async function checkForUpdate() {
+  try {
+    const res = await fetch(`https://registry.npmjs.org/${PKG_NAME}/latest`, {
+      signal: AbortSignal.timeout(3e3)
+    });
+    if (!res.ok) return null;
+    const data = await res.json();
+    const latest = data.version;
+    const current = currentVersion();
+    if (current && newerVersion(current, latest)) return latest;
+    return null;
+  } catch {
+    return null;
+  }
+}
+
 // src/ui/App.tsx
 import { Fragment as Fragment2, jsx as jsx9, jsxs as jsxs9 } from "react/jsx-runtime";
 function App() {
@@ -1737,10 +1792,16 @@ function App() {
   const [activeCtx, setActiveCtx] = useState4(null);
   const [state, setState] = useState4("loading");
   const [cursor, setCursor] = useState4(0);
+  const [updateAvailable, setUpdateAvailable] = useState4(null);
   const [input, setInput] = useState4("");
   const [paletteCursor, setPaletteCursor] = useState4(0);
   const [filePickerCursor, setFilePickerCursor] = useState4(0);
   const agent = useAgentRunner(cfg.model, activeCtx);
+  useEffect3(() => {
+    checkForUpdate().then((v) => {
+      if (v) setUpdateAvailable(v);
+    });
+  }, []);
   useEffect3(() => {
     listModels().then((m) => {
       setModels(m);
@@ -1801,6 +1862,7 @@ function App() {
   })();
   return /* @__PURE__ */ jsxs9(Box9, { flexDirection: "column", paddingX: 1, children: [
     /* @__PURE__ */ jsx9(WelcomeBlock, { model: cfg.model, activeCtx, effort, cwd, error: agent.error }),
+    updateAvailable && /* @__PURE__ */ jsx9(Box9, { marginLeft: 2, marginBottom: 1, children: /* @__PURE__ */ jsx9(Text9, { color: "yellow", children: `\u2191 update available: v${updateAvailable} \u2014 run: npm i -g miii-agent` }) }),
     state === "loading" && !agent.error && /* @__PURE__ */ jsx9(Box9, { marginLeft: 2, marginBottom: 1, children: /* @__PURE__ */ jsx9(Text9, { dimColor: true, children: "connecting to ollama\u2026" }) }),
     agent.error && state !== "ready" && /* @__PURE__ */ jsx9(
       ChatView,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miii-agent",
-  "version": "0.1.0",
+  "version": "0.1.4",
   "description": "Terminal AI coding agent powered by Ollama",
   "type": "module",
   "bin": {