xonecas.io
64875
Mc

mini-coder / commit 4a563e3

Initial commit: Add README introducing mini-coder

xonecas2026-02-20 4a563e3bd8d68701ad1be12beba0d9ff595bd5a1

1 file changed

README.md+120โˆ’0
@@ -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.*