mini-coder 0.0.17 → 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 +4827 -4486
  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/docs/configs.md CHANGED
@@ -1,13 +1,13 @@
1
1
  # Config conventions
2
2
 
3
- mini-coder supports both its native `.agents` convention and Claude Code's `.claude` convention for commands and skills.
3
+ mini-coder supports both its native `.agents` convention and `.claude` layouts for commands, skills, and agents.
4
4
 
5
5
  ## Supported config roots
6
6
 
7
7
  | Root | Purpose |
8
8
  |---|---|
9
9
  | `.agents/` | mini-coder native config |
10
- | `.claude/` | Claude Code-compatible commands/skills |
10
+ | `.claude/` | Alternate config layout supported by mini-coder |
11
11
 
12
12
  Each root can exist in:
13
13
 
@@ -58,20 +58,52 @@ Skill instructions/content.
58
58
 
59
59
  If `name` is omitted, folder name is used.
60
60
 
61
- ## Agents (mini-coder specific)
61
+ ## Agents
62
62
 
63
- Custom subagents are configured in `.agents`:
63
+ Supported locations:
64
64
 
65
65
  - `./.agents/agents/*.md`
66
66
  - `~/.agents/agents/*.md`
67
+ - `./.claude/agents/*.md`
68
+ - `~/.claude/agents/*.md`
69
+
70
+ Format:
71
+
72
+ ```md
73
+ ---
74
+ description: Optional help text
75
+ model: optional/model-override
76
+ mode: optional agent mode
77
+ ---
78
+
79
+ Agent system prompt.
80
+ ```
81
+
82
+ ## Context files
83
+
84
+ mini-coder loads at most one global context file and at most one local context file, then includes both when present.
85
+
86
+ Global lookup order:
87
+
88
+ 1. `~/.agents/AGENTS.md`
89
+ 2. `~/.agents/CLAUDE.md`
90
+
91
+ Local lookup order:
92
+
93
+ 1. `./.agents/AGENTS.md`
94
+ 2. `./CLAUDE.md`
95
+ 3. `./AGENTS.md`
96
+
97
+ Injection order:
67
98
 
68
- (There is no `.claude` compatibility path for agents. Claude doesn't have custom subagents)
99
+ 1. Global context (if found)
100
+ 2. Local context (if found)
69
101
 
70
102
  ## Precedence and conflicts
71
103
 
72
- Precedence rules:
104
+ Precedence rules for commands, skills, and agents:
73
105
 
74
106
  1. **Local overrides global**
75
- 2. At the **same scope** (both local or both global), if `.agents` and `.claude` define the same command/skill name, **`.agents` wins**
107
+ 2. At the **same scope** (both local or both global), if `.agents` and `.claude` define the same name, **`.agents` wins**
76
108
 
77
- When same-scope conflicts are detected for commands/skills, mini-coder prints a warning and uses the `.agents` version.
109
+ When same-scope conflicts are detected for commands, skills, or agents, mini-coder prints a warning and uses the `.agents` version.
package/docs/custom-agents.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # Custom Agents
2
2
 
3
- An agent is a subagent with a custom system prompt and optional model override.
4
- Use `@agent-name` anywhere in your prompt to route the message through it.
3
+ A custom agent is a reusable system prompt with an optional model override.
4
+ You can activate one with `/agent <name>`, and non-`primary` agents are also exposed to the `subagent` tool.
5
5
 
6
6
  ## Where to put them
7
7
 
@@ -9,8 +9,10 @@ Use `@agent-name` anywhere in your prompt to route the message through it.
9
9
  |---|---|
10
10
  | `.agents/agents/*.md` | Current repo only |
11
11
  | `~/.agents/agents/*.md` | All projects (global) |
12
+ | `.claude/agents/*.md` | Current repo only (`.claude` layout) |
13
+ | `~/.claude/agents/*.md` | All projects (global, `.claude` layout) |
12
14
 
13
- Local agents override global ones with the same name.
15
+ Local agents override global ones with the same name. At the same scope, `.agents` wins over `.claude`.
14
16
 
15
17
  ## Create an agent
16
18
 
@@ -33,12 +35,11 @@ No flattery. End with a one-line verdict.
33
35
  Then in the REPL:
34
36
 
35
37
  ```
36
- @reviewer review the auth module for race conditions
38
+ /agent reviewer
39
+ review the auth module for race conditions
37
40
  ```
38
41
 
39
- The rest of the message (everything except the `@reviewer` token) becomes
40
- the prompt. The agent runs in its own context window and returns its output
41
- into the conversation.
42
+ You can also mention `@reviewer` in a prompt as a naming convention, and agent names participate in `@` tab completion alongside skills and files.
42
43
 
43
44
  ## Frontmatter fields
44
45
 
@@ -46,22 +47,22 @@ into the conversation.
46
47
  |---|---|---|
47
48
  | `description` | No | Shown in `/help`. Defaults to filename. |
48
49
  | `model` | No | Override the active model for this agent. |
49
- | `mode` | No | `primary` — interactive only (via `/agent <name>`); `subagent` — callable via the `subagent` tool only (default); `all` — both. |
50
-
50
+ | `mode` | No | Controls whether the agent is exposed through the `subagent` tool. `primary` excludes it from that tool and is intended for `/agent`. `subagent`, `all`, and an omitted value all keep it available to the `subagent` tool. Any loaded agent can currently still be selected with `/agent <name>`. |
51
51
 
52
52
  The markdown body (after frontmatter) is the agent's system prompt.
53
53
 
54
54
  ## Combining with files
55
55
 
56
- `@file` references are resolved before the agent fires:
56
+ File references are resolved before the prompt is sent:
57
57
 
58
58
  ```
59
- @reviewer @src/auth/session.ts check this file for issues
59
+ /agent reviewer
60
+ @src/auth/session.ts check this file for issues
60
61
  ```
61
62
 
62
63
  ## Tab completion
63
64
 
64
- Type `@` and press `Tab` to autocomplete agent names alongside files.
65
+ Type `@` and press `Tab` to autocomplete agent names alongside skills and files.
65
66
 
66
67
  ## Listing agents
67
68
 
@@ -69,4 +70,4 @@ Type `@` and press `Tab` to autocomplete agent names alongside files.
69
70
  /help
70
71
  ```
71
72
 
72
- Agents are listed in magenta, tagged `(local)` or `(global)`.
73
+ Agents are listed in magenta, tagged `(local)` or `(global)`.
package/docs/custom-commands.md CHANGED
@@ -8,8 +8,10 @@ Custom commands let you define reusable prompts that run as `/command` in the mi
8
8
  |---|---|
9
9
  | `.agents/commands/*.md` | Current repo only |
10
10
  | `~/.agents/commands/*.md` | All projects (global) |
11
+ | `.claude/commands/*.md` | Current repo only (Claude-compatible) |
12
+ | `~/.claude/commands/*.md` | All projects (global, Claude-compatible) |
11
13
 
12
- Local commands override global ones with the same name.
14
+ Local commands override global ones with the same name. At the same scope, `.agents` wins over `.claude`.
13
15
 
14
16
  ## Create a command
15
17
 
@@ -21,7 +23,6 @@ Create a markdown file. The filename becomes the command name.
21
23
  ---
22
24
  description: Summarise what changed since yesterday
23
25
  model: zen/claude-haiku-4-5
24
-
25
26
  ---
26
27
 
27
28
  Run `!`git log --oneline --since=yesterday`` and summarise the changes
@@ -44,8 +45,6 @@ Then in the REPL:
44
45
  | `subtask` | No | Set to `true` to force subagent execution (OpenCode-compatible alias for `context: fork`). |
45
46
  | `agent` | No | Run the command under a named agent's system prompt (only applies when `context: fork`). |
46
47
 
47
-
48
-
49
48
  ## Arguments
50
49
 
51
50
  Use `$ARGUMENTS` for the full argument string, or `$1`, `$2`, … `$9` for individual tokens.
@@ -56,7 +55,6 @@ Use `$ARGUMENTS` for the full argument string, or `$1`, `$2`, … `$9` for indiv
56
55
  ---
57
56
  description: Search the codebase for a topic
58
57
  model: zen/claude-haiku-4-5
59
-
60
58
  ---
61
59
 
62
60
  Search the codebase for: $ARGUMENTS
@@ -117,7 +115,6 @@ lightweight tasks regardless of what the session is currently set to.
117
115
  ---
118
116
  description: Quick grep for a symbol
119
117
  model: zen/claude-haiku-4-5
120
-
121
118
  ---
122
119
 
123
120
  Find all usages of $ARGUMENTS across the codebase using grep and glob.
@@ -126,7 +123,6 @@ List each occurrence with file path and line number. No explanations needed.
126
123
 
127
124
  Large models for deep analysis, small models for search and lookup.
128
125
 
129
-
130
126
  ## Precedence
131
127
 
132
128
  Custom commands shadow built-ins. If you create `.agents/commands/plan.md`
@@ -134,7 +130,6 @@ it will replace the built-in `/plan` for that project. The global `/review`
134
130
  command (auto-created at `~/.agents/commands/review.md` on first run) works
135
131
  the same way — a local `.agents/commands/review.md` will override it.
136
132
 
137
-
138
133
  ## Listing commands
139
134
 
140
135
  ```
@@ -142,4 +137,4 @@ the same way — a local `.agents/commands/review.md` will override it.
142
137
  ```
143
138
 
144
139
  Custom commands are listed at the bottom under **custom commands**, tagged
145
- with `(local)` or `(global)`.
140
+ with `(local)` or `(global)`.
package/docs/skills.md CHANGED
@@ -15,8 +15,10 @@ Each skill is a folder containing a `SKILL.md`:
15
15
  |---|---|
16
16
  | `.agents/skills/<name>/SKILL.md` | Current repo only |
17
17
  | `~/.agents/skills/<name>/SKILL.md` | All projects (global) |
18
+ | `.claude/skills/<name>/SKILL.md` | Current repo only (Claude-compatible) |
19
+ | `~/.claude/skills/<name>/SKILL.md` | All projects (global, Claude-compatible) |
18
20
 
19
- Local skills override global ones with the same name.
21
+ Local skills override global ones with the same name. At the same scope, `.agents` wins over `.claude`.
20
22
 
21
23
  ## Create a skill
22
24
 
@@ -60,7 +62,7 @@ included in the message sent to the LLM.
60
62
 
61
63
  ## Tab completion
62
64
 
63
- Type `@` and press `Tab` to autocomplete skill names alongside files.
65
+ Type `@` and press `Tab` to autocomplete skill names alongside agents and files.
64
66
 
65
67
  ## Listing skills
66
68
 
@@ -68,4 +70,4 @@ Type `@` and press `Tab` to autocomplete skill names alongside files.
68
70
  /help
69
71
  ```
70
72
 
71
- Skills are listed in yellow, tagged `(local)` or `(global)`.
73
+ Skills are listed in yellow, tagged `(local)` or `(global)`.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mini-coder",
3
- "version": "0.0.17",
3
+ "version": "0.0.18",
4
4
  "description": "A small, fast CLI coding agent",
5
5
  "module": "src/index.ts",
6
6
  "type": "module",