mini-coder 0.1.0 → 0.1.2

package/.claude/settings.local.json

@@ -1,32 +1,45 @@
 {
-  "permissions": {
-    "allow": [
-      "WebSearch",
-      "WebFetch(domain:github.com)",
-      "WebFetch(domain:dev.to)",
-      "WebFetch(domain:mariozechner.at)",
-      "WebFetch(domain:lobste.rs)",
-      "WebFetch(domain:reading.sh)",
-      "WebFetch(domain:daveswift.com)",
-      "Bash(grep:*)",
-      "Bash(ls:*)",
-      "Bash(bun run:*)",
-      "Bash(git stash:*)",
-      "Bash(gh pr:*)",
-      "Bash(git status:*)",
-      "Bash(git add:*)",
-      "Bash(git commit:*)",
-      "Bash(sqlite3:*)",
-      "Bash(git branch:*)",
-      "Bash(git checkout:*)",
-      "Bash(npm info:*)",
-      "Bash(npm install:*)",
-      "Bash(find:*)",
-      "Bash(git log:*)",
-      "Bash(npm ls:*)",
-      "Bash(gh api:*)",
-      "Bash(bun:*)",
-      "Bash(npx tsc:*)"
-    ]
-  }
+	"permissions": {
+		"allow": [
+			"WebSearch",
+			"WebFetch(domain:github.com)",
+			"WebFetch(domain:dev.to)",
+			"WebFetch(domain:mariozechner.at)",
+			"WebFetch(domain:lobste.rs)",
+			"WebFetch(domain:reading.sh)",
+			"WebFetch(domain:daveswift.com)",
+			"Bash(grep:*)",
+			"Bash(ls:*)",
+			"Bash(bun run:*)",
+			"Bash(git stash:*)",
+			"Bash(gh pr:*)",
+			"Bash(git status:*)",
+			"Bash(git add:*)",
+			"Bash(git commit:*)",
+			"Bash(sqlite3:*)",
+			"Bash(git branch:*)",
+			"Bash(git checkout:*)",
+			"Bash(npm info:*)",
+			"Bash(npm install:*)",
+			"Bash(find:*)",
+			"Bash(git log:*)",
+			"Bash(npm ls:*)",
+			"Bash(gh api:*)",
+			"Bash(bun:*)",
+			"Bash(npx tsc:*)",
+			"WebFetch(domain:docs.anthropic.com)",
+			"WebFetch(domain:sdk.vercel.ai)",
+			"WebFetch(domain:ai-sdk.dev)",
+			"WebFetch(domain:www.npmjs.com)",
+			"Bash(curl -sL https://registry.npmjs.org/opencode-anthropic-auth/-/opencode-anthropic-auth-0.0.13.tgz)",
+			"Bash(tar xz:*)",
+			"Bash(tmux new-session:*)",
+			"Bash(tmux capture-pane:*)",
+			"Bash(tmux list-sessions:*)",
+			"Bash(tmux kill-session:*)",
+			"Bash(python3:*)",
+			"Bash(echo \"EXIT: $?\")",
+			"Bash(xargs cat:*)"
+		]
+	}
 }

package/README.md

@@ -6,194 +6,75 @@
 
 > _Small. Fast. Gets out of your way._
 
-[📖 Read the Full Manual](https://sacenox.github.io/mini-coder/)
+[📖 Read the Full Manual](docs/mini-coder.1.md)
 
-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.
-
----
-
-## 🤙 Who Am I?
-
-I'm `mc` — your new terminal companion. I live in your shell, speak to large language models, and help you explore, understand, and modify code at the speed of thought.
-
-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.
+A terminal coding agent for developers who want a sharp tool, not a bloated IDE plugin. Shell-first, multi-provider, minimal tool surface. Just you, your terminal, and an AI that keeps up.
 
 ![Minicoder Preview](./assets/preview.gif)
 
 ---
 
-## 🛠️ What Can I Do?
-
-My toolkit is lean on purpose — every tool earns its spot, no passengers:
-
-| Tool            | What it does                                                               |
-| --------------- | -------------------------------------------------------------------------- |
-| 🐚 `shell`      | Run shell commands, inspect the repo, and use `mc-edit` for targeted edits |
-| 🤖 `subagent`   | Spawn a focused mini-me for parallel subtasks                              |
-| 🧰 `listSkills` | List discovered skills without loading full skill bodies                   |
-| 📘 `readSkill`  | Load one `SKILL.md` on demand                                              |
-| 🌐 `webSearch`  | Search the web when `EXA_API_KEY` is set                                   |
-| 📄 `webContent` | Fetch full page content from URLs when `EXA_API_KEY` is set                |
-
-mini-coder is intentionally **shell-first**: inspect with shell, edit with `mc-edit`, verify with shell.
-
-Need more firepower? I also connect to **MCP servers** over HTTP or stdio — attached MCP tools show up dynamically whenever the job calls for them.
-
----
-
-## ⚡ Key Features
-
-- **Multi-provider** — set `OPENCODE_API_KEY` for Zen, `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GOOGLE_API_KEY` or `GEMINI_API_KEY`, or just run Ollama locally (`OLLAMA_BASE_URL` optional). I auto-discover whatever's available.
-- **Built-in web search** — set `EXA_API_KEY` and I expose `webSearch` + `webContent` tools.
-- **Session memory** — conversations are saved in a local SQLite database. Resume where you left off with `-c` or pick a specific session with `-r <id>`.
-- **Shell integration** — prefix with `!` to run shell commands inline. Use `@` to reference files in your prompt (with Tab completion).
-- **Slash commands** — `/model` or `/models` to list/switch models, `/model effort <low|medium|high|xhigh|off>` for reasoning effort, `/reasoning [on|off]` to toggle reasoning display, `/context` to inspect or tune pruning/tool-result caps, `/cache` to configure prompt caching, `/review` for a code review (global custom command, auto-created at `~/.agents/commands/review.md`), `/agent [name]` to set or clear an active primary agent, `/undo` to remove the last conversation turn (it does not revert filesystem changes), `/new` for a clean session, `/mcp list|add|remove` to manage MCP servers, and `/exit` (`/quit`, `/q`) to leave. See all with `/help`.
-
-- **Custom commands** — drop a `.md` file in `.agents/commands/` and it becomes a `/command`. Claude-compatible `.claude/commands/` works too. Supports argument placeholders (`$ARGUMENTS`, `$1`…`$9`) and shell interpolation (`` !`cmd` ``). Global commands live in `~/.agents/commands/` and `~/.claude/commands/`. Custom commands take precedence over built-ins. → [docs/custom-commands.md](docs/custom-commands.md)
-- **Custom agents** — drop a `.md` file in `.agents/agents/` or `.claude/agents/` (or `~/.agents/agents/` / `~/.claude/agents/` globally) and activate it with `/agent [name]`. Agent definitions are also exposed to subagent delegation unless `mode: primary`. → [docs/custom-agents.md](docs/custom-agents.md)
-- **Skills** — place a `SKILL.md` in `.agents/skills/<name>/` and inject it into any prompt with `@skill-name`. Claude-compatible `.claude/skills/<name>/SKILL.md` works too. Skills are _never_ auto-loaded — always explicit. → [docs/skills.md](docs/skills.md)
-- **Beautiful, minimal output** — compact tool output, formatted trees for file searches, a live status bar with model, git branch, and token counts.
-- **16 ANSI colors only** — my output inherits _your_ terminal theme. Dark mode, light mode, Solarized, Gruvbox — I fit right in.
-
----
-
-## 🧠 Interesting Things About Me
-
-- **I eat my own dog food.** I was built _by_ a mini-coder agent. It's agents all the way down. 🐢
-- **I'm tiny but mighty.** The whole runtime is [Bun.js](https://bun.com) — fast startup, native TypeScript, and a built-in SQLite driver.
-- **I respect existing conventions.** Context lives in `AGENTS.md` or `CLAUDE.md`, commands in `.agents/commands/`, agents in `.agents/agents/`, skills in `.agents/skills/` — I follow the ecosystem instead of inventing new standards.
-- **I spin while I think.** ⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏ (It's the little things.)
-- **I can clone myself.** The `subagent` tool lets me spin up parallel instances of myself to tackle independent subtasks simultaneously. Divide and conquer! (Up to 10 levels deep.)
-
----
-
-## 📁 Config folders
-
-I follow the [`.agents` convention](https://github.com/agentsmd/agents) — the shared standard across AI coding tools — and I also understand `.claude` layouts for **commands**, **skills**, and **agents**.
-
-| Path                             | What it does                                          |
-| -------------------------------- | ----------------------------------------------------- |
-| `.agents/commands/*.md`          | Custom slash commands (`/name`)                       |
-| `.claude/commands/*.md`          | Claude-compatible custom commands                     |
-| `.agents/agents/*.md`            | Custom agents                                         |
-| `.claude/agents/*.md`            | Alternate `.claude` path for custom agents            |
-| `.agents/skills/<name>/SKILL.md` | Reusable skill instructions (`@name`)                 |
-| `.claude/skills/<name>/SKILL.md` | Claude-compatible skills                              |
-| `.agents/AGENTS.md`              | Preferred local project context                       |
-| `CLAUDE.md`                      | Local fallback context if `.agents/AGENTS.md` is absent |
-| `AGENTS.md`                      | Local fallback context if `.agents/AGENTS.md` and `CLAUDE.md` are absent |
-| `~/.agents/AGENTS.md`            | Preferred global context, prepended before local context |
-| `~/.agents/CLAUDE.md`            | Global fallback context if `~/.agents/AGENTS.md` is absent |
-
-Global commands, agents, and skills also work from `~/.agents/...` and `~/.claude/...`.
-
-For commands, skills, and agents: local overrides global, and `.agents` overrides `.claude` at the same scope. Context files are combined differently: global context is injected first, then local context. → [docs/configs.md](docs/configs.md)
-
----
-
-## 🚀 Getting Started
+## ⚡ Quick Start
 
-One thing before you dive in: **I run on Bun**. You can install me via npm just fine, but [Bun](https://bun.com) still needs to be on your machine — no way around it.
+I run on [Bun](https://bun.com) — install me via bun or npm, but Bun needs to be on your machine.
 
 ```bash
-# Install globally
-bun add -g mini-coder
-# or: npm install -g mini-coder
-
-# Set a provider key (pick one — or run Ollama locally)
-export OPENCODE_API_KEY=your-zen-key    # recommended
-export ANTHROPIC_API_KEY=your-key       # direct Anthropic
-export OPENAI_API_KEY=your-key          # direct OpenAI
-export GOOGLE_API_KEY=your-key          # direct Gemini
-# or: export GEMINI_API_KEY=your-key
-
-# Optional extras
-export OLLAMA_BASE_URL=http://localhost:11434
-export EXA_API_KEY=your-exa-key         # enables webSearch/webContent
-
-# Launch
-mc
-```
-
-Or drop me a prompt straight away for one-shot mode (runs once, then exits):
+# Install
+bun add -g mini-coder   # or: npm install -g mini-coder
 
-```bash
-mc "Refactor the auth module to use async/await"
-```
+# Set one API key (pick any)
+export OPENCODE_API_KEY=your-key     # recommended
+export ANTHROPIC_API_KEY=your-key    # direct Anthropic
+export OPENAI_API_KEY=your-key       # direct OpenAI
+export GOOGLE_API_KEY=your-key       # direct Gemini (or GEMINI_API_KEY)
 
-Useful flags:
+# Optional
+export OLLAMA_BASE_URL=http://localhost:11434   # local models
+export EXA_API_KEY=your-key                     # web search tools
 
-```bash
-mc -c                           # continue last session
-mc -r <id>                      # resume a specific session
-mc -l                           # list recent sessions
-mc -m zen/claude-sonnet-4-6     # pick a model
-mc --cwd ~/src/other-project    # set working directory
-mc -h                           # show help
+# Go
+mc
 ```
 
----
-
-## 🗃️ App data
-
-Everything I remember lives in `~/.config/mini-coder/` — here's what I'm holding onto:
+One-shot mode: `mc "refactor auth to use async/await"` — runs once, then exits.
 
-- `sessions.db` — your full session history, MCP server config, and model metadata, all in one tidy SQLite file
-- `api.log` — a request/response log for every provider call this run, if you want to peek under the hood
-- `errors.log` — anything that went sideways, caught and written down so you can actually debug it
+Useful flags: `-c` continue last session, `-r <id>` resume, `-l` list sessions, `-m <model>` pick a model, `-h` help.
 
 ---
 
-## 📚 Go Deeper
+## 🔑 OAuth Login
 
-The README hits the highlights — the docs have the full story:
-
-- [docs/custom-commands.md](docs/custom-commands.md)
-- [docs/custom-agents.md](docs/custom-agents.md)
-- [docs/skills.md](docs/skills.md)
-- [docs/configs.md](docs/configs.md)
-
-## 🗂️ Project Structure
-
-```
-src/
-  index.ts          # Entry point + CLI arg parsing
-  agent/            # Main REPL loop + tool registry
-  cli/              # Input, output, slash commands, markdown rendering
-  llm-api/          # Provider factory + streaming turn logic
-  tools/            # shell, subagent, skill tools
-                    #   + webSearch, webContent
-  internal/         # shared internals, including the mc-edit helper implementation
-  mcp/              # MCP server connections
-  session/          # SQLite-backed session & history management
-```
+Use `/login` inside the REPL to authenticate via browser-based OAuth (currently Anthropic). No need to manage API keys manually.
 
 ---
 
-## 🔮 Tech Stack
+## 🛠️ Features
 
-- **Runtime:** [Bun.js](https://bun.com) — fast, modern, all-in-one
-- **LLM routing:** [AI SDK](https://ai-sdk.dev) — multi-provider with streaming
-- **Colors:** [yoctocolors](https://github.com/sindresorhus/yoctocolors) — tiny and terminal-theme-aware
-- **Schema validation:** [Zod](https://zod.dev)
-- **Linting/formatting:** [Biome](https://biomejs.dev)
-- **Storage:** `bun:sqlite` — zero-dependency local sessions
+- **Multi-provider** — auto-discovers Anthropic, OpenAI, Gemini, Ollama, or any OpenAI-compatible endpoint
+- **Session memory** — SQLite-backed. Resume with `-c` or `-r <id>`
+- **Shell integration** — `!` prefix for inline commands, `@` to reference files with tab completion
+- **Web search** — `webSearch` + `webContent` tools when `EXA_API_KEY` is set
+- **MCP support** — connect external tool servers over HTTP or stdio
+- **Custom commands** — drop `.md` files in `.agents/commands/` → instant `/slash` commands
+- **Custom agents** — `.agents/agents/*.md` for specialized personas you can activate with `/agent`
+- **Skills** — `.agents/skills/<name>/SKILL.md`, inject with `@name`
+- **`mc-edit`** — safe, exact-text file editing (no full-file rewrites)
+- **16 ANSI colors** — inherits your terminal theme. Always looks right.
 
 ---
 
-## 💬 Philosophy
+## 📚 Getting Deeper
 
-> Accurate. Fast. Focused on the conversation.
+The README is the highlight reel. For the full story — slash commands, config folders, context files, app data, and everything else:
 
-I believe the best tools disappear into your workflow. I don't want to be the star of the show — I want _you_ to ship great code, faster.
+**[📖 Read the Full Manual](docs/mini-coder.1.md)**
 
 ---
 
-## 💬 What People Are Saying
+## 🔮 Tech Stack
 
-> "sean this is fucking sick"
-> — [vpr99](https://github.com/vpr99)
+[Bun.js](https://bun.com) · [AI SDK](https://ai-sdk.dev) · [yoctocolors](https://github.com/sindresorhus/yoctocolors)
 
----
+## 📄 License
 
-_Built with ❤️ and a healthy obsession with terminal aesthetics._
+MIT — [github.com/sacenox/mini-coder](https://github.com/sacenox/mini-coder)

package/dist/mc-edit.js

@@ -3,6 +3,7 @@
 
 // src/cli/structured-output.ts
 import { createTwoFilesPatch } from "diff";
+import * as c from "yoctocolors";
 function normalizePatchLines(patchText) {
   const patchLines = patchText.split(`
 `);
@@ -17,14 +18,30 @@ function normalizePatchLines(patchText) {
     return line;
   });
 }
-function renderUnifiedDiff(filePath, before, after) {
+function colorizeDiffLine(line) {
+  if (line.startsWith("---") || line.startsWith("+++"))
+    return c.dim(line);
+  if (line.startsWith("@@"))
+    return c.cyan(line);
+  if (line.startsWith("+"))
+    return c.green(line);
+  if (line.startsWith("-"))
+    return c.red(line);
+  return line;
+}
+function renderUnifiedDiff(filePath, before, after, options) {
   if (before === after) {
     return "(no changes)";
   }
   const patchText = createTwoFilesPatch(filePath, filePath, before, after, "", "", {
     context: 3
   });
-  return normalizePatchLines(patchText).join(`
+  const lines = normalizePatchLines(patchText);
+  if (options?.colorize) {
+    return lines.map(colorizeDiffLine).join(`
+`);
+  }
+  return lines.join(`
 `);
 }
 function renderMetadataBlock(result) {
@@ -43,8 +60,11 @@ function renderMetadataBlock(result) {
 }
 function writeFileEditResult(io, result) {
   if (result.ok) {
+    const colorize = process.env.FORCE_COLOR === "1" || process.env.FORCE_COLOR === "true";
     const sections = [
-      renderUnifiedDiff(result.path, result.before, result.after),
+      renderUnifiedDiff(result.path, result.before, result.after, {
+        colorize
+      }),
       renderMetadataBlock(result)
     ];
     io.stdout(`${sections.join(`
@@ -64,7 +84,7 @@ function stripMatchingQuotes(value) {
   if (value.length < 2)
     return value;
   const first = value[0];
-  const last = value[value.length - 1];
+  const last = value.at(-1);
   if ((first === '"' || first === "'") && first === last) {
     return value.slice(1, -1);
   }
@@ -76,7 +96,11 @@ function normalizePathInput(pathInput) {
 function resolvePath(cwdInput, pathInput) {
   const cwd = cwdInput ?? process.cwd();
   const normalizedInput = normalizePathInput(pathInput);
-  const expanded = normalizedInput.startsWith("~/") ? join(homedir(), normalizedInput.slice(2)) : normalizedInput === "~" ? homedir() : normalizedInput;
+  let expanded = normalizedInput;
+  if (normalizedInput.startsWith("~/"))
+    expanded = join(homedir(), normalizedInput.slice(2));
+  else if (normalizedInput === "~")
+    expanded = homedir();
   const filePath = expanded.startsWith("/") ? expanded : join(cwd, expanded);
   const relPath = relative(cwd, filePath);
   return { cwd, filePath, relPath };