xonecas.io
64875
Mc

mini-coder / files

mini-coder / README.md

2.7 KB
1<p align="center">
2  <img src="demo.gif" alt="mini-coder demo" />
3</p>
4
5# mini-coder
6
7Minimalistic terminal coding agent, with an emphasis on giving you control of what is sent to
8the model, and visibility into the model's actions.
9
10Beautiful TUI with Tokyo Night colors, more to come soon.
11
12We try to render diffs when the agent uses bash to edit, only for the current working directory; changes outside it aren't tracked.
13
14## Install
15
16```sh
17npm i -g mini-coder
18```
19
20## Configuration
21
22You can use `/login` and `/provider` to configure in the TUI. Changes are saved to your config.
23
24Global config lives at `~/.config/mini-coder/config.json` (`$XDG_CONFIG_HOME/mini-coder/config.json`
25if set). You can also configure your provider and model there:
26
27```json
28{
29  "provider": "opencode-go",
30  "model": "deepseek-v4.1-flash"
31}
32```
33
34Defaults for the rest:
35
36```json
37{
38  "sessionsDir": "./sessions",
39  "systemPrompt": "",
40  "discoverAgentFiles": true,
41  "skillsDirs": [],
42  "tools": ["edit", "read", "bash"],
43  "thinkingEffort": "medium",
44  "customProviders": []
45}
46```
47
48- `provider` / `model` — any model from the `pi-ai` catalog. Requires a discoverable api key
49  from the environment (like `OPENCODE_API_KEY`). When neither is set, the agent launches;
50  sending a message reports that no model is configured.
51- `sessionsDir` — where append-only session JSONL files are written. (no relative paths for now, absolute paths only).
52- `systemPrompt` — the base of the system prompt. Skills and agent files, if
53  enabled, are appended after it.
54- `discoverAgentFiles` — when true, appends `AGENTS.md` / `CLAUDE.md` found in `~/.agents`
55  and the working directory to the system prompt.
56- `skillsDirs` — directories of skills to advertise (`<dir>/<skill>/SKILL.md` with
57  `name:` and `description:` frontmatter). Paths, not contents, go to the model.
58- `tools` — which of `edit`, `read`, `bash` the agent gets. Tool arguments are untrusted
59  and validated at this boundary regardless.
60- `thinkingEffort` — `minimal`, `low`, `medium`, `high`, `xhigh`, or `max` for models
61  that support reasoning.
62
63### Local and custom models
64
65Hosted and local models are equals. Add unlisted or self-hosted models through
66`customProviders` — the four wire APIs come from `pi-ai`, and auth resolves from your
67environment via `envKeys` (no local model needs it):
68
69```json
70{
71  "customProviders": [
72    {
73      "id": "ollama",
74      "name": "Ollama",
75      "baseUrl": "http://localhost:11434/v1",
76      "api": "openai-completions",
77      "models": ["qwen3-coder:30b", "gpt-oss:20b"]
78    }
79  ]
80}
81```
82
83`api` is `openai-completions`, `openai-responses`, `anthropic-messages`, or
84`google-generative-ai`. Then point `provider` and `model` at it.