mini-coder 0.1.1 → 0.2.0

package/docs/mini-coder.1.md

@@ -46,31 +46,19 @@ Developer-focused CLI coding agent. Prioritizes dev flow — no slow startup, no
 `/model effort` *low|medium|high|xhigh|off*
 : Set reasoning effort.
 
-`/reasoning` \[*on|off*\]
-: Toggle reasoning display.
-
-`/context prune` *off|balanced|aggressive*
-: Pruning strategy.
-
-`/context cap` *off|bytes|kb*
-: Tool result payload cap.
-
-`/cache` *on|off*
-: Toggle prompt caching globally.
-
-`/cache openai` *in_memory|24h*
-: OpenAI cache retention.
+`/session` \[*id*\]
+: List sessions or switch to one.
 
-`/cache gemini` *off|cachedContents/...*
-: Gemini cached content.
+`/new`
+: Start a fresh session.
 
 `/undo`
 : Remove last turn (does NOT revert filesystem).
 
-`/new`
-: Start a fresh session.
+`/reasoning` \[*on|off*\]
+: Toggle reasoning display.
 
-`/verbose`
+`/verbose` \[*on|off*\]
 : Toggle output truncation.
 
 `/mcp list`
@@ -85,11 +73,8 @@ Developer-focused CLI coding agent. Prioritizes dev flow — no slow startup, no
 `/mcp remove` *name*
 : Remove MCP server.
 
-`/agent` \[*name*\]
-: Set or clear active primary agent.
-
 `/review`
-: Review changes (custom command, auto-created globally).
+: Review recent changes (global skill, auto-created at first run).
 
 `/login`
 : Show OAuth login status.
@@ -109,19 +94,36 @@ Developer-focused CLI coding agent. Prioritizes dev flow — no slow startup, no
 ## INLINE FEATURES
 
 `!` prefix
-: Runs shell commands inline.
+: Runs shell commands inline — output is sent to the LLM as a user message.
 
 `@` prefix
-: References files or skills (with tab completion).
+: Embeds a file into the prompt (Tab to complete file paths).
+
+`/` prefix
+: Reference a skill in the prompt (Tab to complete skill names).
+
+## KEYS
+
+`ESC`
+: Interrupt the assistant response — partial output is preserved in history.
+
+`Ctrl+C`
+: Exit forcefully.
+
+`Ctrl+D`
+: Graceful exit (EOF).
+
+`↑` / `↓`
+: Navigate command history.
+
+`Ctrl+R`
+: Search command history.
 
 ## BUILT-IN TOOLS
 
 **shell**
 : Execute bash commands; repo inspection and `mc-edit` edits happen here.
 
-**subagent**
-: Spawn a focused mini-agent for parallel subtasks.
-
 **listSkills**
 : List discovered skills (metadata only).
 
@@ -153,58 +155,6 @@ mc-edit <path> (--old <text> | --old-file <path>) [--new <text> | --new-file <pa
 
 Workflow: inspect with **shell** → edit with **mc-edit** → verify with **shell**.
 
-## CUSTOM COMMANDS
-
-Drop a `.md` file in `.agents/commands/` (local) or `~/.agents/commands/` (global) and it becomes a `/command`. Filename equals command name (`standup.md` → `/standup`).
-
-`.claude/commands/*.md` is also supported.
-
-**Frontmatter fields:**
-
-`description`
-: Shown in `/help`.
-
-`model`
-: Override model (only with `context: fork`).
-
-`context`
-: `fork` to run as isolated subagent; default is inline.
-
-`subtask`
-: `true` forces subagent (OpenCode-compatible alias).
-
-`agent`
-: Run under named agent's system prompt (only with `context: fork`).
-
-**Argument substitution:**
-
-`$ARGUMENTS` expands to the full argument string; `$1`–`$9` expand to positional tokens.
-
-**Shell interpolation:**
-
-`` !`cmd` `` injects shell output at expansion time (10 s timeout).
-
-**Precedence:** custom commands shadow built-ins. Local overrides global.
-
-## CUSTOM AGENTS
-
-Drop a `.md` file in `.agents/agents/` (local) or `~/.agents/agents/` (global). Filename equals agent name. Activate with `/agent <name>`.
-
-`.claude/agents/*.md` is also supported.
-
-**Frontmatter fields:**
-
-`description`
-: Shown in `/help`.
-
-`model`
-: Override active model.
-
-`mode`
-: `primary` excludes from subagent tool; `subagent`/`all`/omitted keeps it available.
-
-Body is the agent system prompt. Non-primary agents are exposed to the **subagent** tool for delegation.
-
 ## SKILLS
 
 Skills are reusable instruction files at `.agents/skills/<name>/SKILL.md`.
@@ -221,18 +171,18 @@ Skills are reusable instruction files at `.agents/skills/<name>/SKILL.md`.
 
 Skills are never auto-loaded. Load explicitly:
 
-- `@skill-name` in prompts (injects body wrapped in `<skill>` XML).
+- `/skill-name` in prompts (injects body as a user message).
 - **listSkills** / **readSkill** tools at runtime.
 
 Local discovery walks up from cwd to the git worktree root.
 
-## CONFIGURATION
+A default **review** skill is created at `~/.agents/skills/review/SKILL.md` on first run if it doesn't exist. It can be customized or shadowed locally.
 
-Supports `.agents` and `.claude` layouts for commands, skills, agents, and context.
+## CONFIGURATION
 
 Config roots: `.agents/`, `.claude/` — local (repo) or global (`~/`).
 
-**Context files** (one global + one local loaded):
+**Context files** (one global + one local loaded into the system prompt):
 
 - Global: `~/.agents/AGENTS.md` → `~/.agents/CLAUDE.md`
 - Local: `./.agents/AGENTS.md` → `./CLAUDE.md` → `./AGENTS.md`
@@ -269,7 +219,7 @@ Config roots: `.agents/`, `.claude/` — local (repo) or global (`~/`).
 : App data directory (sessions.db, api.log, errors.log).
 
 `.agents/` or `.claude/`
-: Config directories for commands, agents, skills.
+: Config directories for skills and context files.
 
 `AGENTS.md` / `CLAUDE.md`
 : Project context files.

package/lefthook.yml

@@ -0,0 +1,15 @@
+pre-commit:
+  parallel: true
+  commands:
+    jscpd:
+      run: bun run jscpd
+    knip:
+      run: bun run knip
+    typecheck:
+      run: bun run typecheck
+    format:
+      run: bun run format
+    lint:
+      run: bun run lint
+    test:
+      run: bun run test

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mini-coder",
-	"version": "0.1.1",
+	"version": "0.2.0",
 	"description": "A small, fast CLI coding agent",
 	"module": "src/index.ts",
 	"type": "module",
@@ -18,7 +18,7 @@
 		"test": "bun test --only-failures",
 		"test:verbose": "bun test",
 		"jscpd": "jscpd src",
-		"ui-oneshot": "bun scripts/ui-oneshot.ts"
+		"prepare": "lefthook install"
 	},
 	"dependencies": {
 		"@ai-sdk/anthropic": "^3.0.60",
@@ -37,6 +37,7 @@
 		"@types/bun": "latest",
 		"jscpd": "^4.0.8",
 		"knip": "^5.86.0",
+		"lefthook": "^2.1.4",
 		"typescript": "^5.9.3"
 	},
 	"knip": {

package/research.md

@@ -1,38 +0,0 @@
-I want your help exploring how could we use yoctocolor to add color ouput to commonly used shell commands. Let's first check the db, check the recent past sessions for a sample. Then check for the shell usage and assert the most common commands
-
-Response:
-
-## Shell Usage Analysis (from 101 sessions)
-
-Most common commands:
-| Command | Count | Opportunity |
-|---------|-------|-------------|
-| `cat` | 72 | File content preview |
-| `git` | 54 | Status/diff output |
-| `bun` | 32 | Test/build output |
-| `sed` | 29 | Transform preview |
-| `mc-edit` | 26 | File edits |
-| `nl` | 12 | Line numbers |
-| `rg` | 11 | Search matches |
-| `npm` | 9 | Package output |
-| `grep` | 7 | Match highlighting |
-| `ls` | 5 | File listings |
-
-## Current Shell Output Coloring (in `tool-result-renderers.ts`)
-
-The shell result renderer already uses yoctocolors:
-
-- **Status badges**: `c.green("done")` / `c.red("error")` / `c.yellow("timeout")`
-- **Stderr lines**: `c.red()` for error emphasis
-- **Stdout/stderr line separators**: `c.dim()` or colored pipe character
-
-## Enhancement Opportunities
-
-1. **Command syntax highlighting** - Color `git`, `bun`, `npm` commands differently in the tool call line
-2. **File path highlighting** - Use `c.cyan()` for paths in output
-3. **Git diffs from mc-edit** - Render a colored diff
-4. **Line numbers** - `nl` output could use `c.yellow()` for numbers
-5. **Git output** - Branch names in `c.cyan()`, commit hashes in `c.yellow()`, file statuses (M/A/D) in color
-6. **rg/grep matches** - Highlight matching text in `c.greenBright()` or `c.yellow()`
-7. **Exit code** - Non-zero codes in `c.red()` or `c.yellow()`
-8. **Test output** - `bun test` results: passes in `c.green()`, fails in `c.red()`, skips in `c.yellow()`