mini-coder 0.5.13 → 0.6.0

package/README.md

@@ -20,7 +20,7 @@
   </picture>
 </p>
 
-mini-coder (`mc`) is a terminal coding agent that reads your repo, edits files, runs commands, and keeps going until the work is done. Small core tool surface, flat architecture, fast turns, and streaming everywhere it matters.
+mini-coder (`mc`) is a terminal coding agent, hand crafted for transparency and good engineering performance.
 
 ## Install
 
@@ -37,125 +37,42 @@ $ mc
 - **Performance** — startup and turn latency matter more than features.
 - **Streaming end-to-end** — assistant text, reasoning, tool calls, and tool output show up as they happen.
 
-## Tools
-
-Six built-in tools, plus a conditional read-only image tool and any configured MCP tools:
-
-- **`shell`** — runs commands in the user's shell. Returns stdout, stderr, and exit code. Large output is truncated to protect model context.
-- **`read`** — reads UTF-8 text files from disk, optionally by line window.
-- **`grep`** — searches file contents with ripgrep-style options and returns structured matches.
-- **`edit`** — exact-text replacement in a single file. Fails deterministically if the target is missing or ambiguous. Creates new files when old text is empty.
-- **`todoWrite`** — creates or updates the session todo list incrementally and returns the full current snapshot.
-- **`todoRead`** — returns the full current session todo list snapshot.
-- **`readImage`** — reads PNG, JPEG, GIF, and WebP files as model input. Only registered when the active model supports images.
-- **Configured MCP tools** — tools discovered from `settings.json` Streamable HTTP MCP servers. Imported tool names are prefixed with the server name, for example `docs__search`.
-
-## Features
-
-- **Multi-provider model support** — Anthropic, OpenAI, Google, Bedrock, Mistral, Groq, xAI, OpenRouter, Ollama, Copilot, and more via pi-ai.
-- **Streaming TUI** — markdown conversation log, tool blocks with diffs, animated divider, multi-line input, and a one-line pill status bar with independent ANSI16 effort/context tones.
-- **Session persistence** — SQLite-backed sessions with undo, fork, resume, and cumulative usage stats. Sessions are scoped to the working directory.
-- **Reasoning and verbosity controls** — toggle thinking visibility and verbose tool rendering on demand. Preferences persist across launches.
-- **[AGENTS.md](https://agents.md) support** — project-specific instructions discovered root-to-leaf, with `~/.agents/` for global instructions.
-- **[Agent Skills](https://agentskills.io)** — skill catalogs exposed in the prompt. `/skill:name` injects a skill body into the next user message, and `/skill` opens a picker that fills in the selected skill reference without submitting.
-- **Settings-driven MCP tools** — connect Streamable HTTP MCP servers from `~/.config/mini-coder/settings.json` and expose their tools directly in the core runtime.
-
-## Commands
-
-| Command       | Description                                                                                                                                                       |
-| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `/model`      | Switch models and save the choice as the global default.                                                                                                          |
-| `/session`    | Open the session picker for the current working directory.                                                                                                        |
-| `/new`        | Start a fresh session and reset the running token and cost totals.                                                                                                |
-| `/fork`       | Fork the current chat into a new session, keep the original, and add a UI-only `Forked session.` note.                                                            |
-| `/undo`       | Remove the last conversational turn without touching filesystem changes.                                                                                          |
-| `/reasoning`  | Show or hide model thinking. The setting is saved and restored on launch.                                                                                         |
-| `/verbose`    | Toggle compact vs full rendering for verbose-aware tool previews/results, including shell, read, grep, edit previews/errors, and MCP tool blocks.                 |
-| `/mcp`        | Open the MCP server picker and toggle configured servers on or off for future turns.                                                                              |
-| `/todo`       | Show the current session todo list in the conversation log as a UI-only checklist block.                                                                          |
-| `/login`      | Sign in with a supported OAuth provider.                                                                                                                          |
-| `/logout`     | Remove saved OAuth credentials for a logged-in provider.                                                                                                          |
-| `/effort`     | Choose low, medium, high, or xhigh reasoning effort.                                                                                                              |
-| `/help`       | Show commands, current toggles, loaded AGENTS.md files, skills, and MCP servers with on/off state.                                                                |
-| `/skill:name` | Insert a discovered skill into the next message. Submit `/skill` or pick `/skill:name` from slash-command autocomplete to choose a skill without auto-submitting. |
-
-## Key bindings
-
-| Key           | Action                                                                                                     |
-| ------------- | ---------------------------------------------------------------------------------------------------------- |
-| `Enter`       | Submit message                                                                                             |
-| `Shift+Enter` | Insert newline                                                                                             |
-| `Escape`      | Dismiss the overlay without changing the draft; otherwise interrupt the running turn; otherwise do nothing |
-| `Tab`         | Autocomplete a path, or open the command picker when the draft starts with `/` without clearing the draft  |
-| `Ctrl+R`      | Search global raw input history                                                                            |
-| `Ctrl+C`      | Graceful exit                                                                                              |
-| `Ctrl+D`      | Graceful exit when the input is empty                                                                      |
-| `:q`          | Graceful exit                                                                                              |
-| `Ctrl+Z`      | Suspend the process                                                                                        |
-| Mouse wheel   | Scroll conversation history                                                                                |
-
-## Headless one-shot mode
-
-mini-coder also supports a non-interactive one-shot mode for scripts and benchmark harnesses.
-
-```bash
-$ mc -p "summarize this repo"
-$ printf '%s\n' 'fix the failing tests' | mc
-```
-
-- Starts when `-p/--prompt` is provided or when stdin or stdout is not a TTY.
-- If stdout is redirected but stdin is still interactive, pass `-p`; headless mode will not fall back to an interactive prompt.
-- Uses the same parser as the TUI for plain text, `/skill:name`, and standalone image paths.
-- Without `--json`, keeps stdout script-friendly by writing only the final assistant text there, while lightweight assistant commentary snippets from tool-use turns go to stderr.
-- With `--json`, writes NDJSON events for completed assistant/tool-result messages plus `done` / `error` / `aborted` outcomes; queued `user_message` events may also appear. Streaming deltas are omitted.
-- Headless runs still persist like normal sessions and show up in `/session` history for that working directory.
-- Interactive slash commands such as `/skill` without a name, `/model`, `/session`, `/mcp`, and `/help` are not available in headless mode.
-
 ## Settings
 
+> Warning, settings have changed, update your old settings file!
+
 Global defaults live in `~/.config/mini-coder/settings.json`.
 
+Create or edit it directly to set the default provider, model, reasoning effort, and any custom models. `customProviders` entries use the pi-ai `Model` shape; the top-level `provider` and `model` select the active entry.
+
 ```json
 {
+  "provider": "ollama",
+  "model": "llama3.1:8b",
+  "effort": "medium",
   "customProviders": [
     {
-      "name": "lm-studio",
-      "baseUrl": "http://127.0.0.1:1234/v1"
+      "id": "llama3.1:8b",
+      "name": "Llama 3.1 8B (Ollama)",
+      "api": "openai-completions",
+      "provider": "ollama",
+      "baseUrl": "http://localhost:11434/v1",
+      "reasoning": false,
+      "input": ["text"],
+      "cost": {
+        "input": 0,
+        "output": 0,
+        "cacheRead": 0,
+        "cacheWrite": 0
+      },
+      "contextWindow": 128000,
+      "maxTokens": 32000
     }
-  ],
-  "mcp": {
-    "servers": [
-      {
-        "name": "docs",
-        "url": "http://127.0.0.1:8787/mcp",
-        "enabled": true
-      }
-    ]
-  }
+  ]
 }
 ```
 
-- `mcp.servers` currently supports Streamable HTTP MCP endpoints.
-- Each server `name` becomes the imported tool prefix, so a remote `search` tool appears as `docs__search`.
-- MCP servers with `enabled: true` connect at startup; disabled ones stay disconnected until you turn them back on.
-- Invalid MCP URLs are skipped immediately, and enabled servers that are unreachable are skipped with a warning.
-- `/mcp` can enable or disable configured MCP servers during the current app run, and that on/off state is persisted.
-
-## Docs
-
-- **Docs site:** https://sacenox.github.io/mini-coder/
-- **Spec:** [`spec.md`](spec.md)
-- **Repo instructions:** [`AGENTS.md`](AGENTS.md)
-
-## Development
-
-```bash
-bun install
-bun test
-bun run check
-bun run format
-bun run typecheck
-```
+Use `api: "openai-completions"` for OpenAI-compatible servers such as Ollama, vLLM, LiteLLM, and local proxies. For local OpenAI-compatible custom providers, mini-coder supplies the dummy API key required by pi-ai when no real key is needed.
 
 ## Also makes LLMs smarter
 

package/bin/mc.ts

@@ -1,14 +1,11 @@
 #!/usr/bin/env bun
-
-/**
- * Executable launcher for the mini-coder CLI.
- *
- * @module
- */
-
 import { main } from "../src/index.ts";
 
-main().catch((err) => {
-  console.error(err instanceof Error ? err.message : String(err));
-  process.exit(1);
-});
+if (import.meta.main) {
+  try {
+    await main();
+  } catch (err) {
+    console.log(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+}