mini-coder 0.0.18 → 0.0.19

package/README.md

@@ -6,6 +6,8 @@
 
 > _Small. Fast. Gets out of your way._
 
+[📖 Read the Full Manual](https://sacenox.github.io/mini-coder/)
+
 Hey there! I'm **mini-coder** — a CLI coding agent built for developers who want a sharp tool, not a bloated IDE plugin. Think of me as the pocket knife of AI coding assistants: lightweight, reliable, and always ready.
 
 ---
@@ -16,16 +18,7 @@ I'm `mc` — your new terminal companion. I live in your shell, speak to large l
 
 I was built with a simple philosophy: **dev flow first**. No slow startup. No clunky GUI. No vendor lock-in. Just you, your terminal, and an AI that keeps up.
 
-```
-$ mc
-┌─ mini-coder ──────────────────────────────────────────┐
-│  What would you like to work on today?                │
-│                                                       │
-│  > _                                                  │
-│                                                       │
-│  [zen/claude-sonnet-4-6] [~/src/my-project] [main] ...│
-└───────────────────────────────────────────────────────┘
-```
+![Minicoder Preview](./assets/preview.gif)
 
 ---
 

package/dist/mc.js

@@ -88,7 +88,7 @@ var terminal = new TerminalIO;
 import * as c from "yoctocolors";
 
 // src/cli/error-log.ts
-import { mkdirSync } from "fs";
+import { mkdirSync, writeFileSync } from "fs";
 import { homedir } from "os";
 import { join } from "path";
 var writer = null;
@@ -98,6 +98,7 @@ function initErrorLog() {
   const dirPath = join(homedir(), ".config", "mini-coder");
   const logPath = join(dirPath, "errors.log");
   mkdirSync(dirPath, { recursive: true });
+  writeFileSync(logPath, "");
   writer = Bun.file(logPath).writer();
   process.on("uncaughtException", (err) => {
     logError(err, "uncaught");
@@ -212,6 +213,12 @@ function parseAppError(err) {
       hint: "Check network or local server"
     };
   }
+  if (code === "ECONNRESET" || message.includes("ECONNRESET") || message.includes("socket connection was closed unexpectedly")) {
+    return {
+      headline: "Connection lost",
+      hint: "The server closed the connection \u2014 retry or switch model with /model"
+    };
+  }
   const firstLine = message.split(`
 `)[0]?.trim() || "Unknown error";
   return { headline: firstLine };
@@ -894,7 +901,7 @@ async function renderTurn(events, spinner, opts) {
 
 // src/cli/output.ts
 var HOME2 = homedir3();
-var PACKAGE_VERSION = "0.0.18";
+var PACKAGE_VERSION = "0.0.19";
 function tildePath(p) {
   return p.startsWith(HOME2) ? `~${p.slice(HOME2.length)}` : p;
 }
@@ -1295,6 +1302,21 @@ function getDb() {
   }
   return _db;
 }
+var MAX_SESSIONS = 100;
+var MAX_PROMPT_HISTORY = 500;
+function pruneOldData() {
+  const db = getDb();
+  const deletedSessions = db.run(`DELETE FROM sessions WHERE id NOT IN (
+       SELECT id FROM sessions ORDER BY updated_at DESC LIMIT ?
+     )`, [MAX_SESSIONS]).changes;
+  const deletedHistory = db.run(`DELETE FROM prompt_history WHERE id NOT IN (
+       SELECT id FROM prompt_history ORDER BY id DESC LIMIT ?
+     )`, [MAX_PROMPT_HISTORY]).changes;
+  if (deletedSessions > 0 || deletedHistory > 0) {
+    db.exec("VACUUM;");
+  }
+  db.exec("PRAGMA wal_checkpoint(TRUNCATE);");
+}
 // src/session/db/mcp-repo.ts
 function listMcpServers() {
   return getDb().query("SELECT name, transport, url, command, args, env FROM mcp_servers ORDER BY name").all();
@@ -2193,18 +2215,47 @@ import { createOpenAI } from "@ai-sdk/openai";
 import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
 
 // src/llm-api/api-log.ts
-import { mkdirSync as mkdirSync3 } from "fs";
+import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync2 } from "fs";
 import { homedir as homedir6 } from "os";
 import { join as join5 } from "path";
 var writer2 = null;
+var MAX_ENTRY_BYTES = 8 * 1024;
 function initApiLog() {
   if (writer2)
     return;
   const dirPath = join5(homedir6(), ".config", "mini-coder");
   const logPath = join5(dirPath, "api.log");
   mkdirSync3(dirPath, { recursive: true });
+  writeFileSync2(logPath, "");
   writer2 = Bun.file(logPath).writer();
 }
+function isObject2(v) {
+  return typeof v === "object" && v !== null;
+}
+var LOG_DROP_KEYS = new Set([
+  "requestBodyValues",
+  "responseBody",
+  "responseHeaders",
+  "stack"
+]);
+function sanitizeForLog(data) {
+  if (!isObject2(data))
+    return data;
+  const result = {};
+  for (const key in data) {
+    if (LOG_DROP_KEYS.has(key))
+      continue;
+    const value = data[key];
+    if (key === "errors" && Array.isArray(value)) {
+      result[key] = value.map((e) => sanitizeForLog(e));
+    } else if (key === "lastError" && isObject2(value)) {
+      result[key] = sanitizeForLog(value);
+    } else {
+      result[key] = value;
+    }
+  }
+  return result;
+}
 function logApiEvent(event, data) {
   if (!writer2)
     return;
@@ -2213,7 +2264,13 @@ function logApiEvent(event, data) {
 `;
   if (data !== undefined) {
     try {
-      entry += JSON.stringify(data, null, 2).split(`
+      const safe = sanitizeForLog(data);
+      let serialized = JSON.stringify(safe, null, 2);
+      if (serialized.length > MAX_ENTRY_BYTES) {
+        serialized = `${serialized.slice(0, MAX_ENTRY_BYTES)}
+  \u2026truncated`;
+      }
+      entry += serialized.split(`
 `).map((line) => `  ${line}`).join(`
 `);
       entry += `
@@ -3162,14 +3219,14 @@ function applyContextPruning(messages, mode) {
     return pruneMessages({
       messages,
       reasoning: "before-last-message",
-      toolCalls: "before-last-2-messages",
+      toolCalls: "before-last-20-messages",
       emptyMessages: "remove"
     });
   }
   return pruneMessages({
     messages,
     reasoning: "before-last-message",
-    toolCalls: "before-last-3-messages",
+    toolCalls: "before-last-40-messages",
     emptyMessages: "remove"
   });
 }
@@ -5513,7 +5570,7 @@ ${c13.bold("Examples:")}`);
 }
 
 // src/cli/bootstrap.ts
-import { existsSync as existsSync5, mkdirSync as mkdirSync5, writeFileSync } from "fs";
+import { existsSync as existsSync5, mkdirSync as mkdirSync5, writeFileSync as writeFileSync3 } from "fs";
 import { homedir as homedir9 } from "os";
 import { join as join11 } from "path";
 import * as c14 from "yoctocolors";
@@ -5539,7 +5596,7 @@ function bootstrapGlobalDefaults() {
   const reviewPath = join11(commandsDir, "review.md");
   if (!existsSync5(reviewPath)) {
     mkdirSync5(commandsDir, { recursive: true });
-    writeFileSync(reviewPath, REVIEW_COMMAND_CONTENT, "utf-8");
+    writeFileSync3(reviewPath, REVIEW_COMMAND_CONTENT, "utf-8");
     writeln(`${c14.green("\u2713")} created ${c14.dim("~/.agents/commands/review.md")} ${c14.dim("(edit it to customise your reviews)")}`);
   }
 }
@@ -6296,7 +6353,9 @@ async function runInputLoop(opts) {
         }
         if (result.type === "inject-user-message") {
           const { text: resolvedText, images: refImages } = await resolveFileRefs(result.text, cwd);
-          await runner.processUserInput(resolvedText, refImages);
+          try {
+            await runner.processUserInput(resolvedText, refImages);
+          } catch {}
         }
         continue;
       }
@@ -6322,7 +6381,9 @@ ${out}
         const { text: resolvedText, images: refImages } = await resolveFileRefs(input.text, cwd);
         const allImages = [...input.images || [], ...refImages];
         if (!runner.ralphMode) {
-          await runner.processUserInput(resolvedText, allImages);
+          try {
+            await runner.processUserInput(resolvedText, allImages);
+          } catch {}
           continue;
         }
         if (allImages.length > 0) {
@@ -6404,6 +6465,7 @@ registerTerminalCleanup();
 initErrorLog();
 initApiLog();
 initModelInfoCache();
+pruneOldData();
 refreshModelInfoInBackground().catch(() => {});
 async function main() {
   const argv = process.argv.slice(2);

package/docs/mini-coder.1.md

@@ -0,0 +1,158 @@
+# MINI-CODER(1)
+
+## NAME
+**mini-coder** (executable: `mc`) - A small, fast CLI coding agent built for developers.
+
+## SYNOPSIS
+`mc [options] [prompt]`
+
+## DESCRIPTION
+**mini-coder** is a developer-focused CLI coding agent. It prioritizes developer flow with no slow startup, no clunky GUI, and no vendor lock-in. It uses a minimalist terminal UI restricted to 16 ANSI colors to inherit the user's terminal theme, and is built entirely on Bun.js for maximum performance.
+
+## OPTIONS
+**-m, --model <id>**
+:   Specify the model to use (e.g., `zen/claude-sonnet-4-6`).
+
+**-c, --continue**
+:   Continue the most recent session.
+
+**-r, --resume <id>**
+:   Resume a specific session by its ID.
+
+**-l, --list**
+:   List recent sessions.
+
+**--cwd <path>**
+:   Set the working directory (defaults to current directory).
+
+**-h, --help**
+:   Display help information.
+
+**[prompt]**
+:   Optional one-shot prompt text before entering interactive mode.
+
+## INTERACTIVE COMMANDS
+Inside the interactive session, the following slash commands are available:
+
+**/model**
+:   List all available models, indicating free models and context sizes.
+
+**/model <id>**
+:   Switch to a specific model.
+
+**/model effort <low|medium|high|xhigh|off>**
+:   Configure reasoning effort levels for models that support it.
+
+**/reasoning [on|off]**
+:   Toggle the display of the model's reasoning/thought process.
+
+**/context prune <off|balanced|aggressive>**
+:   Configure context window pruning strategies.
+
+**/context cap <off|bytes|kb>**
+:   Set a hard payload cap size for tool results to avoid blowing out context.
+
+**/cache <on|off>**
+:   Toggle prompt caching globally.
+
+**/cache openai <in_memory|24h>**
+:   Set OpenAI prompt cache retention policies.
+
+**/cache gemini <off|cachedContents/...>**
+:   Attach Google Gemini cached content.
+
+**/plan**
+:   Toggle read-only planning mode.
+
+**/ralph**
+:   Toggle autonomous execution looping.
+
+**/undo**
+:   Revert the last turn and restore files.
+
+**/new**
+:   Clear context and start a fresh session.
+
+**/mcp list**
+:   List configured MCP servers.
+
+**/mcp add <name> http <url>**
+:   Add an MCP server over HTTP.
+
+**/mcp add <name> stdio <cmd> [args...]**
+:   Add an MCP server over stdio.
+
+**/mcp remove <name>** (or **rm**)
+:   Remove an MCP server.
+
+**/agent [name]**
+:   Set or clear an active primary custom agent.
+
+**/help**
+:   Display command help.
+
+**/exit, /quit, /q**
+:   Leave the session.
+
+## INLINE FEATURES
+**Shell Integration**
+:   Prefix user prompts with `!` to run shell commands inline directly into the context.
+
+**File & Agent Referencing**
+:   Prefix words with `@` to reference files, custom agents, or skills within prompts (supports tab completion).
+
+## BUILT-IN TOOLS
+The agent has access to the following tools:
+*   **glob**: Discover files by glob pattern across the project.
+*   **grep**: Search file contents using regular expressions.
+*   **read**: Read file contents with line-range pagination support.
+*   **create**: Write a new file or completely overwrite an existing one.
+*   **replace**: Replace or delete targeted lines using hashline anchors.
+*   **insert**: Insert new lines before/after an anchor without replacing existing content.
+*   **shell**: Execute bash commands and capture output.
+*   **subagent**: Spawn a focused mini-agent with a prompt.
+*   **webSearch**: Search the internet (requires EXA key).
+*   **webContent**: Fetch full page content from a URL (requires EXA key).
+
+## ENVIRONMENT
+**OPENCODE_API_KEY**
+:   OpenCode Zen API key (Recommended provider).
+
+**ANTHROPIC_API_KEY**
+:   Direct Anthropic API key.
+
+**OPENAI_API_KEY**
+:   Direct OpenAI API key.
+
+**GOOGLE_API_KEY** (or **GEMINI_API_KEY**)
+:   Direct Google Gemini API key.
+
+**OLLAMA_BASE_URL**
+:   Ollama local base URL (Defaults to `http://localhost:11434`).
+
+**EXA_API_KEY**
+:   Enables built-in `webSearch` and `webContent` tools.
+
+## FILES & DIRECTORIES
+**~/.config/mini-coder/**
+:   Application data directory. Contains `sessions.db` (SQLite database for session history, tool snapshots, MCP server configs, and model metadata), `api.log`, and `errors.log`.
+
+**.agents/ or .claude/ (Local or Global in ~/)**
+:   Configuration directories for advanced features:
+    *   **commands/*.md**: Custom slash commands.
+    *   **agents/*.md**: Custom behavioral wrappers or subagents.
+    *   **skills/<name>/SKILL.md**: Isolated context/instruction snippets.
+    *   **hooks/post-<tool>**: Executable scripts triggered upon tool execution.
+
+**AGENTS.md / CLAUDE.md**
+:   Auto-loaded system context files for project-specific instructions.
+
+## CORE FEATURES & ARCHITECTURE
+*   **Multi-Provider LLM Routing**: Automatically discovers API keys to route to OpenCode (Zen), Anthropic, OpenAI, Google/Gemini, or local Ollama instances.
+*   **Session Memory**: Persists conversation history in a local SQLite database, allowing users to resume past sessions effortlessly.
+*   **Subagent Delegation**: Includes a tool to spawn parallel instances of itself to tackle independent subtasks simultaneously (up to 10 levels deep).
+*   **Autonomous Mode (Ralph)**: An autonomous looping mode that runs tasks in an isolated context loop (up to 20 iterations) until completion.
+*   **Plan Mode**: A read-only thinking mode utilizing read tools + MCP, safely analyzing code without making mutations or executing shell commands.
+*   **Model Context Protocol (MCP)**: Native support for connecting external tools via MCP servers over HTTP or stdio.
+*   **Prompt Caching**: Configurable caching behaviors for supported providers (OpenAI, Gemini).
+*   **Undo Functionality**: Roll back the last conversation turn, cleanly restoring previous file states and git history via snapshots.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mini-coder",
-	"version": "0.0.18",
+	"version": "0.0.19",
 	"description": "A small, fast CLI coding agent",
 	"module": "src/index.ts",
 	"type": "module",

package/docs/chatgpt-subscription-auth.md

@@ -1,68 +0,0 @@
-# ChatGPT/Codex subscription auth notes
-
-mini-coder does **not** currently support logging in with a ChatGPT Plus/Pro/Codex subscription.
-
-## Why
-
-We looked at two implementations:
-
-- OpenCode in `/tmp/opencode-src`
-- official Codex in `/tmp/openai-codex/codex-rs`
-
-Both rely on OpenAI **first-party/private** auth and backend APIs rather than a documented public developer API.
-
-## What those implementations do
-
-### Auth
-
-They use OAuth-like flows against `https://auth.openai.com`, including:
-
-- browser login with PKCE and a localhost callback server
-- device-code / headless login
-- refresh tokens via `POST /oauth/token`
-
-Both also rely on a hardcoded first-party client id embedded in their source trees.
-
-Examples:
-
-- official Codex: `/tmp/openai-codex/codex-rs/core/src/auth.rs`
-- OpenCode: `/tmp/opencode-src/packages/opencode/src/plugin/codex.ts`
-
-### Runtime API
-
-After login, requests are sent to ChatGPT backend endpoints such as:
-
-- `https://chatgpt.com/backend-api/codex`
-- `https://chatgpt.com/backend-api/codex/responses`
-
-with headers like:
-
-- `Authorization: Bearer <oauth access token>`
-- `ChatGPT-Account-Id: <account id>`
-
-Examples:
-
-- official Codex: `/tmp/openai-codex/codex-rs/core/src/model_provider_info.rs`
-- official Codex headers: `/tmp/openai-codex/codex-rs/backend-client/src/client.rs`
-- OpenCode rewrite layer: `/tmp/opencode-src/packages/opencode/src/plugin/codex.ts`
-
-## Why mini-coder is not adopting this
-
-- It depends on undocumented/private auth endpoints.
-- It depends on a hardcoded first-party client id.
-- It depends on private ChatGPT backend routes.
-- Browser login would require running a local callback server.
-- Even the official Codex source does not expose a clean public API-based alternative here.
-
-## Future stance
-
-We may revisit support if OpenAI exposes a stable, documented path for:
-
-- ChatGPT subscription login for third-party tools, or
-- a public Codex/ChatGPT backend API intended for external clients
-
-Until then, mini-coder only supports providers with clearer public integration paths.
-
-## Note
-
-If you want a supported hosted integration instead of ChatGPT subscription auth, mini-coder already supports OpenCode Zen via `OPENCODE_API_KEY`. See the existing `zen/<model>` provider path.