xonecas.io
64875
Mc

mini-coder / commit 498b9d8

fix: gh-pages

xonecas2026-04-29 498b9d8681587109516b26a250acc6fd268aa298 parent 7a2d01b

1 file changed

index.html+500−0
@@ -0,0 +1,500 @@
1+<!doctype html>
2+<html lang="en" class="scroll-smooth">
3+ <head>
4+ <meta charset="utf-8" />
5+ <meta name="viewport" content="width=device-width, initial-scale=1" />
6+ <title>mini-coder — terminal coding agent</title>
7+ <meta
8+ name="description"
9+ content="mini-coder is a Bun/TypeScript terminal coding agent with streamed output, a small bash/edit/task tool surface, AGENTS.md and skills support, and settings plus sessions under ~/.config/mini-coder/."
10+ />
11+ <meta name="theme-color" content="#0a0e14" />
12+ <link
13+ rel="icon"
14+ href="assets/icon-2-dark-terminal.svg"
15+ type="image/svg+xml"
16+ />
17+ <link rel="preconnect" href="https://fonts.googleapis.com" />
18+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
19+ <link
20+ href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:ital,wght@0,300;0,400;0,500;0,600;0,700;1,400&display=swap"
21+ rel="stylesheet"
22+ />
23+ <script src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"></script>
24+ <style type="text/tailwindcss">
25+ @theme {
26+ --color-term-bg: #0a0e14;
27+ --color-term-surface: #0d1117;
28+ --color-term-panel: #161b22;
29+ --color-term-border: #21262d;
30+ --color-term-fg: #b2b9c2;
31+ --color-term-bright: #e6edf3;
32+ --color-term-muted: #545d68;
33+ --color-term-accent: #00d4ff;
34+ --color-term-green: #3fb950;
35+ --color-term-yellow: #d29922;
36+ --color-term-red: #f85149;
37+ --color-term-magenta: #bc8cff;
38+ --color-term-blue: #58a6ff;
39+ --font-mono:
40+ "JetBrains Mono", ui-monospace, "Cascadia Code", "Source Code Pro",
41+ Menlo, Consolas, "DejaVu Sans Mono", monospace;
42+ }
43+
44+ ::selection {
45+ background: color-mix(
46+ in srgb,
47+ var(--color-term-accent) 30%,
48+ transparent
49+ );
50+ color: var(--color-term-bright);
51+ }
52+
53+ ::-webkit-scrollbar {
54+ width: 6px;
55+ }
56+
57+ ::-webkit-scrollbar-track {
58+ background: var(--color-term-bg);
59+ }
60+
61+ ::-webkit-scrollbar-thumb {
62+ background: var(--color-term-border);
63+ border-radius: 3px;
64+ }
65+
66+ ::-webkit-scrollbar-thumb:hover {
67+ background: var(--color-term-muted);
68+ }
69+
70+ @keyframes blink {
71+ 0%,
72+ 100% {
73+ opacity: 1;
74+ }
75+ 50% {
76+ opacity: 0;
77+ }
78+ }
79+
80+ .cursor-blink {
81+ animation: blink 1s step-end infinite;
82+ }
83+
84+ .glow-accent {
85+ text-shadow: 0 0 8px
86+ color-mix(in srgb, var(--color-term-accent) 40%, transparent);
87+ }
88+
89+ .manual h2 {
90+ @apply mt-8 mb-4 flex items-center gap-2 text-lg font-semibold text-term-accent;
91+ }
92+
93+ .manual h2::before {
94+ content: "##";
95+ @apply text-sm font-normal text-term-muted;
96+ }
97+
98+ .manual h3 {
99+ @apply mt-6 mb-2 text-base font-semibold text-term-bright;
100+ }
101+
102+ .manual p {
103+ @apply mb-4 leading-relaxed text-term-fg;
104+ }
105+
106+ .manual ul,
107+ .manual ol {
108+ @apply mb-4 pl-6 text-term-fg;
109+ }
110+
111+ .manual li {
112+ @apply mb-1 leading-relaxed;
113+ }
114+
115+ .manual ul li::marker {
116+ @apply text-term-muted;
117+ }
118+
119+ .manual strong {
120+ @apply font-semibold text-term-bright;
121+ }
122+
123+ .manual a {
124+ @apply text-term-blue underline decoration-term-blue/30 underline-offset-2 transition-colors hover:decoration-term-blue/80;
125+ }
126+
127+ .manual code {
128+ @apply rounded bg-term-panel px-1.5 py-0.5 text-sm text-term-magenta;
129+ }
130+
131+ .manual blockquote {
132+ @apply my-4 border-l-2 border-term-accent/50 pl-4 italic text-term-muted;
133+ }
134+
135+ kbd {
136+ @apply rounded border border-term-border bg-term-panel px-1.5 py-0.5 text-xs text-term-bright;
137+ }
138+ </style>
139+ </head>
140+ <body class="bg-term-bg font-mono text-term-fg antialiased">
141+ <!-- top bar -->
142+ <nav
143+ class="sticky top-0 z-40 border-b border-term-border bg-term-bg/90 backdrop-blur-sm"
144+ >
145+ <div
146+ class="mx-auto flex h-10 max-w-4xl items-center justify-between px-4 sm:px-6"
147+ >
148+ <div class="flex items-center gap-3">
149+ <img
150+ src="assets/icon-2-dark-terminal.svg"
151+ alt="mini-coder icon"
152+ class="h-5 w-5 rounded-sm"
153+ />
154+ <span class="font-bold text-term-accent glow-accent">mini</span
155+ ><span class="text-term-muted">-coder</span>
156+ <span class="hidden text-xs text-term-muted sm:inline">&middot;</span>
157+ <span class="hidden text-xs text-term-muted sm:inline"
158+ >terminal coding agent</span
159+ >
160+ </div>
161+ <div class="flex items-center gap-4 text-xs">
162+ <a
163+ class="text-term-muted transition-colors hover:text-term-accent"
164+ href="#manual"
165+ >manual</a
166+ >
167+ <a
168+ class="text-term-muted transition-colors hover:text-term-accent"
169+ href="#tools"
170+ >tools</a
171+ >
172+ <a
173+ class="text-term-muted transition-colors hover:text-term-accent"
174+ href="https://github.com/sacenox/mini-coder"
175+ >github</a
176+ >
177+ </div>
178+ </div>
179+ </nav>
180+
181+ <!-- hero -->
182+ <header class="mx-auto max-w-4xl px-4 pt-16 pb-12 sm:px-6">
183+ <div class="mb-6 flex items-start gap-4">
184+ <img
185+ src="assets/icon-2-dark-terminal.svg"
186+ alt="mini-coder logo"
187+ class="mt-1 hidden h-14 w-14 rounded-xl border border-term-border bg-term-panel p-2 shadow-[0_0_30px_rgba(0,212,255,0.06)] sm:block"
188+ />
189+ <div>
190+ <h1 class="text-4xl font-bold tracking-tight sm:text-5xl">
191+ <span class="text-term-accent glow-accent">mini</span
192+ ><span class="text-term-bright">-coder</span>
193+ </h1>
194+ <p class="mt-2 text-sm text-term-muted sm:text-base">
195+ Lightning fast coding agent for your terminal.
196+ </p>
197+ </div>
198+ </div>
199+
200+ <!-- terminal prompt -->
201+ <div
202+ class="overflow-hidden rounded-lg border border-term-border bg-term-surface"
203+ >
204+ <div
205+ class="flex items-center gap-2 border-b border-term-border bg-term-panel px-4 py-2"
206+ >
207+ <span class="h-3 w-3 rounded-full bg-term-red/80"></span>
208+ <span class="h-3 w-3 rounded-full bg-term-yellow/80"></span>
209+ <span class="h-3 w-3 rounded-full bg-term-green/80"></span>
210+ <span class="ml-2 text-xs text-term-muted">~</span>
211+ </div>
212+ <div class="space-y-2 p-4 text-sm">
213+ <div class="flex gap-2">
214+ <span class="select-none text-term-accent">$</span>
215+ <span class="text-term-bright">bun add -g mini-coder</span>
216+ </div>
217+ <div class="flex gap-2">
218+ <span class="select-none text-term-accent">$</span>
219+ <span class="text-term-bright">mc</span>
220+ <span
221+ class="inline-block h-[1.2em] w-2 self-center bg-term-accent/70 cursor-blink"
222+ ></span>
223+ </div>
224+ </div>
225+ </div>
226+
227+ <!-- quick links -->
228+ <div class="mt-6 flex flex-wrap gap-3 text-xs">
229+ <a
230+ class="rounded-md border border-term-border bg-term-panel px-3 py-1.5 text-term-fg transition-all hover:border-term-accent/50 hover:text-term-accent"
231+ href="#why"
232+ >Overview &rarr;</a
233+ >
234+ <a
235+ class="rounded-md border border-term-border bg-term-panel px-3 py-1.5 text-term-fg transition-all hover:border-term-accent/50 hover:text-term-accent"
236+ href="#workflow"
237+ >Workflow &rarr;</a
238+ >
239+ <a
240+ class="rounded-md border border-term-border bg-term-panel px-3 py-1.5 text-term-fg transition-all hover:border-term-accent/50 hover:text-term-accent"
241+ href="#tools"
242+ >Tools &rarr;</a
243+ >
244+ <a
245+ class="rounded-md border border-term-border bg-term-panel px-3 py-1.5 text-term-fg transition-all hover:border-term-accent/50 hover:text-term-accent"
246+ href="#interface"
247+ >Interface &rarr;</a
248+ >
249+ <a
250+ class="rounded-md border border-term-border bg-term-panel px-3 py-1.5 text-term-fg transition-all hover:border-term-accent/50 hover:text-term-accent"
251+ href="#settings"
252+ >Settings &rarr;</a
253+ >
254+ <a
255+ class="rounded-md border border-term-border bg-term-panel px-3 py-1.5 text-term-fg transition-all hover:border-term-accent/50 hover:text-term-accent"
256+ href="#headless"
257+ >Headless &rarr;</a
258+ >
259+ <a
260+ class="rounded-md border border-term-border bg-term-panel px-3 py-1.5 text-term-fg transition-all hover:border-term-accent/50 hover:text-term-accent"
261+ href="https://github.com/sacenox/mini-coder"
262+ >GitHub &rarr;</a
263+ >
264+ </div>
265+
266+ <!-- preview -->
267+ <div
268+ class="mt-8 overflow-hidden rounded-lg border border-term-border bg-term-surface"
269+ >
270+ <img
271+ src="assets/preview.gif"
272+ alt="mini-coder terminal session preview"
273+ class="block w-full"
274+ />
275+ </div>
276+ </header>
277+
278+ <!-- content -->
279+ <main id="manual" class="manual mx-auto max-w-4xl px-4 pb-16 sm:px-6">
280+ <section id="why">
281+ <h2>mini-coder</h2>
282+ <p>
283+ mini-coder (<code>mc</code>) is a terminal coding agent. The current
284+ <code>main</code> branch is a Bun/TypeScript implementation focused on
285+ reading files, running shell commands, editing code, and writing new
286+ files with a small core tool surface.
287+ </p>
288+ <ul>
289+ <li>
290+ <strong>Lean runtime.</strong> The project uses
291+ <a href="https://github.com/badlogic/pi-mono/tree/main/packages/ai"
292+ >pi-ai</a
293+ >
294+ for provider APIs, streaming, tool calling, usage tracking, and
295+ OAuth, plus
296+ <a href="https://github.com/sacenox/cel-tui">cel-tui</a> for the
297+ terminal UI.
298+ </li>
299+ <li>
300+ <strong>Streaming interface.</strong> Assistant text, reasoning,
301+ tool calls, and tool output are rendered as they arrive.
302+ </li>
303+ <li>
304+ <strong>Local state.</strong> Settings, OAuth credentials, and
305+ sessions are stored under
306+ <code>~/.config/mini-coder/</code>.
307+ </li>
308+ </ul>
309+ </section>
310+
311+ <section id="tools">
312+ <h2>Tools</h2>
313+ <p>
314+ The current built-in runtime tools are intentionally small. Multi-step
315+ work is delegated to <code>task</code>; direct <code>bash</code> and
316+ <code>edit</code> calls remain available for immediate actions.
317+ </p>
318+ <div class="mb-4 grid gap-4 md:grid-cols-3">
319+ <article
320+ class="rounded-lg border border-term-border bg-term-surface p-4"
321+ >
322+ <h3 class="mt-0 mb-2 font-semibold text-term-bright">bash</h3>
323+ <p class="mb-0 text-sm leading-relaxed text-term-fg">
324+ Executes shell commands in the current working directory, strips
325+ ANSI output, reports the exit code, and writes very large results
326+ to a temporary file after a short preview.
327+ </p>
328+ </article>
329+ <article
330+ class="rounded-lg border border-term-border bg-term-surface p-4"
331+ >
332+ <h3 class="mt-0 mb-2 font-semibold text-term-bright">edit</h3>
333+ <p class="mb-0 text-sm leading-relaxed text-term-fg">
334+ Performs exact-text replacement in one file, creates new files
335+ when <code>oldText</code> is empty, and refuses missing or
336+ ambiguous matches.
337+ </p>
338+ </article>
339+ <article
340+ class="rounded-lg border border-term-border bg-term-surface p-4"
341+ >
342+ <h3 class="mt-0 mb-2 font-semibold text-term-bright">task</h3>
343+ <p class="mb-0 text-sm leading-relaxed text-term-fg">
344+ Runs a bounded subagent with the same model and prompt context for
345+ exploration or implementation work that needs more than one direct
346+ tool call.
347+ </p>
348+ </article>
349+ </div>
350+ </section>
351+
352+ <section id="interface">
353+ <h2>Interface</h2>
354+ <p>
355+ The TUI is a scrollable conversation log with markdown rendering, tool
356+ call blocks, a multiline input, and status pills for model, working
357+ directory, git branch, activity, and context usage.
358+ </p>
359+ <div class="grid gap-4 md:grid-cols-2">
360+ <article
361+ class="rounded-lg border border-term-border bg-term-surface p-4"
362+ >
363+ <h3 class="mt-0 mb-2 font-semibold text-term-bright">Controls</h3>
364+ <ul class="mb-0 text-sm">
365+ <li><kbd>Enter</kbd> submits the current message.</li>
366+ <li>
367+ <kbd>Escape</kbd> aborts a running turn or clears a non-empty
368+ draft.
369+ </li>
370+ <li>
371+ <kbd>Ctrl+P</kbd> opens the menu for providers, models,
372+ reasoning effort, and cwd-scoped sessions.
373+ </li>
374+ <li>
375+ <kbd>Ctrl+C</kbd>, <kbd>Ctrl+D</kbd>, or <kbd>Ctrl+Q</kbd>
376+ exits cleanly.
377+ </li>
378+ <li>
379+ <code>:q</code> exits; <code>:n</code> or <code>/new</code>
380+ starts a fresh session.
381+ </li>
382+ <li>Mouse wheel scrolling reviews conversation history.</li>
383+ </ul>
384+ </article>
385+ <article
386+ class="rounded-lg border border-term-border bg-term-surface p-4"
387+ >
388+ <h3 class="mt-0 mb-2 font-semibold text-term-bright">
389+ Menu actions
390+ </h3>
391+ <ul class="mb-0 text-sm">
392+ <li>Switch to an available API-key or OAuth-backed provider.</li>
393+ <li>Choose a model from the selected provider.</li>
394+ <li>
395+ Set reasoning effort: minimal, low, medium, high, or xhigh.
396+ </li>
397+ <li>Resume saved sessions for the current working directory.</li>
398+ </ul>
399+ </article>
400+ </div>
401+ </section>
402+
403+ <section id="settings">
404+ <h2>Settings, sessions, and context</h2>
405+ <p>
406+ Global settings live in
407+ <code>~/.config/mini-coder/settings.json</code>. The current schema
408+ stores <code>provider</code>, <code>model</code>,
409+ <code>effort</code>, and optional <code>customProviders</code> entries
410+ using the pi-ai model shape.
411+ </p>
412+ <ul>
413+ <li>
414+ <strong>Provider setup.</strong> mini-coder detects providers with
415+ environment API keys, supports OAuth login with
416+ <code>--login</code> for OAuth-capable providers, and accepts
417+ <code>--provider</code>, <code>--model</code>, and
418+ <code>--effort</code> overrides.
419+ </li>
420+ <li>
421+ <strong>Sessions.</strong> Conversations are saved as JSON files in
422+ <code>~/.config/mini-coder/sessions/</code> and listed only for the
423+ working directory they came from.
424+ </li>
425+ <li>
426+ <strong>Instructions.</strong> mini-coder loads global
427+ <code>~/.agents/AGENTS.md</code> and local <code>./AGENTS.md</code>
428+ content when present.
429+ </li>
430+ <li>
431+ <strong>Skills.</strong> Skill metadata is discovered from
432+ <code>~/.agents/skills/*/SKILL.md</code> and
433+ <code>./.agents/skills/*/SKILL.md</code> and added to the prompt.
434+ </li>
435+ </ul>
436+ </section>
437+
438+ <section id="headless">
439+ <h2>Headless one-shot mode</h2>
440+ <p>
441+ For non-interactive use, pass a prompt with <code>-p</code> or
442+ <code>--prompt</code>. Headless mode uses the same core agent loop and
443+ tools, then writes completed user, assistant, and tool-result messages
444+ as JSON lines.
445+ </p>
446+ <div class="rounded-lg border border-term-border bg-term-surface p-4">
447+ <pre
448+ class="overflow-x-auto text-sm text-term-bright"
449+ ><code>$ mc -p "summarize this repo"
450+$ mc --provider openai-codex --model gpt-5.5 --effort xhigh -p "fix the failing tests"</code></pre>
451+ </div>
452+ </section>
453+
454+ <section id="stack">
455+ <h2>Built on proven parts</h2>
456+ <p>
457+ mini-coder uses
458+ <a href="https://github.com/badlogic/pi-mono/tree/main/packages/ai"
459+ >pi-ai</a
460+ >
461+ for provider support and streaming, and
462+ <a href="https://github.com/sacenox/cel-tui">cel-tui</a> for the
463+ terminal UI. The page is static HTML and intentionally stays close to
464+ the current <code>main</code> branch behavior.
465+ </p>
466+ </section>
467+ </main>
468+
469+ <!-- footer -->
470+ <footer
471+ class="mx-auto max-w-4xl border-t border-term-border px-4 pt-6 pb-8 sm:px-6"
472+ >
473+ <div
474+ class="flex flex-col items-center justify-between gap-2 text-xs text-term-muted sm:flex-row"
475+ >
476+ <span
477+ >MIT License &middot; Built with
478+ <a href="https://bun.sh" class="text-term-blue hover:underline"
479+ >Bun</a
480+ ></span
481+ >
482+ <div class="flex items-center gap-4">
483+ <a
484+ class="transition-colors hover:text-term-accent"
485+ href="https://github.com/sacenox/mini-coder"
486+ >GitHub</a
487+ >
488+ <a
489+ class="transition-colors hover:text-term-accent"
490+ href="https://www.npmjs.com/package/mini-coder"
491+ >npm</a
492+ >
493+ <a class="transition-colors hover:text-term-accent" href="#manual"
494+ >Manual</a
495+ >
496+ </div>
497+ </div>
498+ </footer>
499+ </body>
500+</html>