@@ -0,0 +1,120 @@
1+# ๐พ mini-coder
2+
3+> *Small. Fast. Gets out of your way.*
4+
5+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.
6+
7+---
8+
9+## ๐ค Who Am I?
10+
11+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.
12+
13+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.
14+
15+```
16+$ mc
17+โโ mini-coder โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
18+โ What would you like to work on today? โ
19+โ โ
20+โ > _ โ
21+โ โ
22+โ [zen/claude-sonnet-4] [~/src/my-project] [main] ... โ
23+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
24+```
25+
26+---
27+
28+## ๐ ๏ธ What Can I Do?
29+
30+I come equipped with a tight, reliable set of tools:
31+
32+| Tool | What it does |
33+|---|---|
34+| ๐ `glob` | Find files by pattern across your project |
35+| ๐งฒ `grep` | Search file contents with regex |
36+| ๐ `read` | Read files (with line-range support) |
37+| โ๏ธ `edit` | Make precise, targeted edits (no full rewrites) |
38+| ๐ `shell` | Run shell commands and see their output |
39+| ๐ค `subagent` | Spawn a focused mini-me for parallel subtasks |
40+
41+I can also connect to **MCP servers** (like Exa for web search), giving you superpowers on demand.
42+
43+---
44+
45+## โก Key Features
46+
47+- **Multi-provider, zero-config** โ set `OPENCODE_API_KEY` and I'll auto-discover providers. Ollama running locally? I'll find that too.
48+- **Session memory** โ conversations are saved in a local SQLite database. Resume where you left off.
49+- **Shell integration** โ prefix with `!` to run shell commands inline. Use `@` to reference files in your prompt.
50+- **Slash commands** โ `/model` to switch models, `/plan` for read-only thinking mode, `/review` for a code review, `/mcp` to manage MCP servers.
51+- **Beautiful, minimal output** โ diffs for edits, formatted trees for file searches, a live status bar with model, git branch, and token counts.
52+- **16 ANSI colors only** โ my output inherits *your* terminal theme. Dark mode, light mode, Solarized, Gruvbox โ I fit right in.
53+
54+---
55+
56+## ๐ง Interesting Things About Me
57+
58+- **I eat my own dog food.** I was built *by* a mini-coder agent. It's agents all the way down. ๐ข
59+- **I'm tiny but mighty.** The whole runtime is [Bun.js](https://bun.com) โ fast startup, native TypeScript, and a built-in SQLite driver.
60+- **I respect existing conventions.** Skill files live in `.agents/`, context in `AGENTS.md` or `CLAUDE.md` โ I follow the ecosystem instead of inventing new standards.
61+- **I spin while I think.** โ โ โ นโ ธโ ผโ ดโ ฆโ งโ โ (It's the little things.)
62+- **I can clone myself.** The `subagent` tool lets me spin up parallel instances of myself to tackle independent subtasks simultaneously. Divide and conquer!
63+
64+---
65+
66+## ๐ Getting Started
67+
68+```bash
69+# Install globally
70+bun install -g .
71+
72+# Set your provider key
73+export OPENCODE_API_KEY=your-key-here
74+
75+# Launch!
76+mc
77+```
78+
79+Or run directly for a quick task:
80+
81+```bash
82+mc "Refactor the auth module to use async/await"
83+```
84+
85+---
86+
87+## ๐๏ธ Project Structure
88+
89+```
90+src/
91+ index.ts # Entry point
92+ agent/ # Main REPL loop + tool registry
93+ cli/ # Input, output, slash commands
94+ llm-api/ # Provider factory + streaming turn logic
95+ tools/ # glob, grep, read, edit, shell, subagent
96+ mcp/ # MCP server connections
97+ session/ # SQLite-backed session & history management
98+```
99+
100+---
101+
102+## ๐ฎ Tech Stack
103+
104+- **Runtime:** [Bun.js](https://bun.com) โ fast, modern, all-in-one
105+- **LLM routing:** [AI SDK](https://ai-sdk.dev) โ multi-provider with streaming
106+- **Colors:** [yoctocolors](https://github.com/sindresorhus/yoctocolors) โ tiny and terminal-theme-aware
107+- **Schema validation:** [Zod](https://zod.dev)
108+- **Storage:** `bun:sqlite` โ zero-dependency local sessions
109+
110+---
111+
112+## ๐ฌ Philosophy
113+
114+> Accurate. Fast. Focused on the conversation.
115+
116+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.
117+
118+---
119+
120+*Built with โค๏ธ and a healthy obsession with terminal aesthetics.*