mini-coder 0.0.16 → 0.0.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/README.md +20 -17
  2. package/dist/mc.js +4883 -4291
  3. package/docs/configs.md +40 -8
  4. package/docs/custom-agents.md +14 -13
  5. package/docs/custom-commands.md +4 -9
  6. package/docs/skills.md +5 -3
  7. package/package.json +1 -1
package/README.md CHANGED
@@ -56,10 +56,10 @@ Need more firepower? I connect to **MCP servers** over HTTP or stdio — bolt on
56
56
  - **Built-in web search** — set `EXA_API_KEY` and I expose `webSearch` + `webContent` tools.
57
57
  - **Session memory** — conversations are saved in a local SQLite database. Resume where you left off with `-c` or pick a specific session with `-r <id>`.
58
58
  - **Shell integration** — prefix with `!` to run shell commands inline. Use `@` to reference files in your prompt (with Tab completion).
59
- - **Slash commands** — `/model` or `/models` to list/switch models, `/model effort <low|medium|high|xhigh|off>` for reasoning effort, `/plan` for read-only thinking mode, `/ralph` for autonomous looping, `/review` for a code review (global custom command, auto-created at `~/.agents/commands/review.md`), `/agent [name]` to set or clear an active primary agent, `/undo` to roll back a turn, `/new` for a clean session, `/mcp list|add|remove` to manage MCP servers, and `/exit` (`/quit`, `/q`) to leave. See all with `/help`.
59
+ - **Slash commands** — `/model` or `/models` to list/switch models, `/model effort <low|medium|high|xhigh|off>` for reasoning effort, `/reasoning [on|off]` to toggle reasoning display, `/context` to inspect or tune pruning/tool-result caps, `/plan` for read-only thinking mode, `/ralph` for autonomous looping, `/review` for a code review (global custom command, auto-created at `~/.agents/commands/review.md`), `/agent [name]` to set or clear an active primary agent, `/undo` to roll back a turn, `/new` for a clean session, `/mcp list|add|remove` to manage MCP servers, and `/exit` (`/quit`, `/q`) to leave. See all with `/help`.
60
60
 
61
61
  - **Custom commands** — drop a `.md` file in `.agents/commands/` and it becomes a `/command`. Claude-compatible `.claude/commands/` works too. Supports argument placeholders (`$ARGUMENTS`, `$1`…`$9`) and shell interpolation (`` !`cmd` ``). Global commands live in `~/.agents/commands/` and `~/.claude/commands/`. Custom commands take precedence over built-ins. → [docs/custom-commands.md](docs/custom-commands.md)
62
- - **Custom agents** — drop a `.md` file in `.agents/agents/` (or `~/.agents/agents/` globally) and reference it with `@agent-name` in your prompt. The agent runs in its own context window with a custom system prompt and optional model override. → [docs/custom-agents.md](docs/custom-agents.md)
62
+ - **Custom agents** — drop a `.md` file in `.agents/agents/` or `.claude/agents/` (or `~/.agents/agents/` / `~/.claude/agents/` globally) and activate it with `/agent [name]`. Agent definitions are also exposed to subagent delegation unless `mode: primary`. `@agent-name` is supported for completion and is a useful prompt convention. → [docs/custom-agents.md](docs/custom-agents.md)
63
63
  - **Skills** — place a `SKILL.md` in `.agents/skills/<name>/` and inject it into any prompt with `@skill-name`. Claude-compatible `.claude/skills/<name>/SKILL.md` works too. Skills are _never_ auto-loaded — always explicit. → [docs/skills.md](docs/skills.md)
64
64
  - **Post-tool hooks** — drop an executable at `.agents/hooks/post-<tool>` (or `~/.agents/hooks/post-<tool>` globally) and I'll run it after matching built-in tool calls. → [docs/tool-hooks.md](docs/tool-hooks.md)
65
65
  - **Beautiful, minimal output** — diffs for edits, formatted trees for file searches, a live status bar with model, git branch, and token counts.
@@ -73,28 +73,32 @@ Need more firepower? I connect to **MCP servers** over HTTP or stdio — bolt on
73
73
  - **I'm tiny but mighty.** The whole runtime is [Bun.js](https://bun.com) — fast startup, native TypeScript, and a built-in SQLite driver.
74
74
  - **I respect existing conventions.** Hook scripts live in `.agents/hooks/`, context in `AGENTS.md` or `CLAUDE.md`, commands in `.agents/commands/`, agents in `.agents/agents/`, skills in `.agents/skills/` — I follow the ecosystem instead of inventing new standards.
75
75
  - **I spin while I think.** ⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏ (It's the little things.)
76
- - **I can clone myself.** The `subagent` tool lets me spin up parallel instances of myself to tackle independent subtasks simultaneously. Divide and conquer! (Up to 3 levels deep.)
76
+ - **I can clone myself.** The `subagent` tool lets me spin up parallel instances of myself to tackle independent subtasks simultaneously. Divide and conquer! (Up to 10 levels deep.)
77
77
 
78
78
  ---
79
79
 
80
80
  ## 📁 Config folders
81
81
 
82
- I follow the [`.agents` convention](https://github.com/agentsmd/agents) — the shared standard across AI coding tools — and I also speak Claude Code's `.claude` format for **commands** and **skills**. Best of both worlds.
82
+ I follow the [`.agents` convention](https://github.com/agentsmd/agents) — the shared standard across AI coding tools — and I also understand `.claude` layouts for **commands**, **skills**, and **agents**.
83
83
 
84
- | Path | What it does |
85
- | -------------------------------- | ------------------------------------------------- |
86
- | `.agents/commands/*.md` | Custom slash commands (`/name`) |
87
- | `.claude/commands/*.md` | Claude-compatible custom commands |
88
- | `.agents/agents/*.md` | Custom agents (`@name`) |
89
- | `.agents/skills/<name>/SKILL.md` | Reusable skill instructions (`@name`) |
90
- | `.claude/skills/<name>/SKILL.md` | Claude-compatible skills |
91
- | `.agents/hooks/post-<tool>` | Scripts run after supported built-in tool calls |
92
- | `AGENTS.md` | Project context injected into every system prompt |
93
- | `CLAUDE.md` | Fallback project context if `AGENTS.md` is absent |
94
- | `~/.agents/AGENTS.md` | Global fallback context |
84
+ | Path | What it does |
85
+ | -------------------------------- | ----------------------------------------------------- |
86
+ | `.agents/commands/*.md` | Custom slash commands (`/name`) |
87
+ | `.claude/commands/*.md` | Claude-compatible custom commands |
88
+ | `.agents/agents/*.md` | Custom agents |
89
+ | `.claude/agents/*.md` | Alternate `.claude` path for custom agents |
90
+ | `.agents/skills/<name>/SKILL.md` | Reusable skill instructions (`@name`) |
91
+ | `.claude/skills/<name>/SKILL.md` | Claude-compatible skills |
92
+ | `.agents/hooks/post-<tool>` | Scripts run after supported built-in tool calls |
93
+ | `.agents/AGENTS.md` | Preferred local project context |
94
+ | `CLAUDE.md` | Local fallback context if `.agents/AGENTS.md` is absent |
95
+ | `AGENTS.md` | Local fallback context if `.agents/AGENTS.md` and `CLAUDE.md` are absent |
96
+ | `~/.agents/AGENTS.md` | Preferred global context, prepended before local context |
97
+ | `~/.agents/CLAUDE.md` | Global fallback context if `~/.agents/AGENTS.md` is absent |
95
98
 
99
+ Global commands, agents, and skills also work from `~/.agents/...` and `~/.claude/...`.
96
100
 
97
- The pecking order is straightforward: local beats global, and `.agents` beats `.claude` at the same scope. Worth noting: custom agents are mini-coder-only — `.claude` compatibility is for commands and skills only. → [docs/configs.md](docs/configs.md)
101
+ For commands, skills, and agents: local overrides global, and `.agents` overrides `.claude` at the same scope. Context files are combined differently: global context is injected first, then local context. → [docs/configs.md](docs/configs.md)
98
102
 
99
103
  ---
100
104
 
@@ -148,7 +152,6 @@ Everything I remember lives in `~/.config/mini-coder/` — here's what I'm holdi
148
152
  - `sessions.db` — your full session history, `/undo` snapshots, MCP server config, and model metadata, all in one tidy SQLite file
149
153
  - `api.log` — a request/response log for every provider call this run, if you want to peek under the hood
150
154
  - `errors.log` — anything that went sideways, caught and written down so you can actually debug it
151
- - `AGENTS.md` — your global context fallback, quietly injected whenever a repo doesn't bring its own `AGENTS.md` or `CLAUDE.md`
152
155
 
153
156
  ---
154
157