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.