mini-coder 0.1.2 → 0.2.1

package/docs/KNOWN_ISSUES.md

@@ -0,0 +1,13 @@
+# KNOWN ISSUES
+
+## Bugs
+
+- `/model` doesn't autocomplete models provider/name pattern.
+- AI SDK expands `claude-3-5-haiku` → dated variant that Zen doesn't serve (404).
+- Shell tool max-timeout leaves the parent terminal in a broken state.
+
+## Features
+
+- Conversation summary on max context instead of just an error with `/new` suggestion.
+
+## Refactors

package/docs/mini-coder.1.md

@@ -6,7 +6,7 @@
 
 ## SYNOPSIS
 
-`mc` \[*options*\] \[*prompt*\]
+`mc` \[_options_\] \[_prompt_\]
 
 ## DESCRIPTION
 
@@ -14,25 +14,25 @@ Developer-focused CLI coding agent. Prioritizes dev flow — no slow startup, no
 
 ## OPTIONS
 
-`-m`, `--model` *id*
+`-m`, `--model` _id_
 : Model to use (e.g. `zen/claude-sonnet-4-6`).
 
 `-c`, `--continue`
 : Continue most recent session.
 
-`-r`, `--resume` *id*
+`-r`, `--resume` _id_
 : Resume a specific session.
 
 `-l`, `--list`
 : List recent sessions.
 
-`--cwd` *path*
+`--cwd` _path_
 : Set working directory.
 
 `-h`, `--help`
 : Display help.
 
-*prompt*
+_prompt_
 : Optional one-shot prompt. Runs once then exits.
 
 ## INTERACTIVE COMMANDS
@@ -40,64 +40,49 @@ Developer-focused CLI coding agent. Prioritizes dev flow — no slow startup, no
 `/model`
 : List all available models.
 
-`/model` *id*
+`/model` _id_
 : Switch model.
 
-`/model effort` *low|medium|high|xhigh|off*
+`/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`
 : List MCP servers.
 
-`/mcp add` *name* `http` *url*
+`/mcp add` _name_ `http` _url_
 : Add HTTP MCP server.
 
-`/mcp add` *name* `stdio` *cmd* \[*args...*\]
+`/mcp add` _name_ `stdio` _cmd_ \[_args..._\]
 : Add stdio MCP server.
 
-`/mcp remove` *name*
+`/mcp remove` _name_
 : Remove MCP server.
 
-`/agent` \[*name*\]
-: Set or clear active agent.
-
 `/review`
-: Review changes (custom command, auto-created globally).
+: Review recent changes (global skill, auto-created at first run).
 
 `/login`
 : Show OAuth login status.
 
-`/login` *provider*
+`/login` _provider_
 : Login via OAuth (opens browser for device flow). Currently supports `anthropic`.
 
-`/logout` *provider*
+`/logout` _provider_
 : Clear saved OAuth tokens.
 
 `/help`
@@ -109,10 +94,30 @@ 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
 
@@ -150,46 +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`
-: Optional metadata field.
-
-**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`
-: Optional metadata field.
-
-Body is the agent system prompt.
-
 ## SKILLS
 
 Skills are reusable instruction files at `.agents/skills/<name>/SKILL.md`.
@@ -206,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`
@@ -254,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

@@ -1,15 +1,4 @@
 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
+    check:
+      run: bun run check

package/package.json

@@ -1,49 +1,51 @@
 {
-	"name": "mini-coder",
-	"version": "0.1.2",
-	"description": "A small, fast CLI coding agent",
-	"module": "src/index.ts",
-	"type": "module",
-	"bin": {
-		"mc": "dist/mc.js",
-		"mc-edit": "dist/mc-edit.js"
-	},
-	"scripts": {
-		"build": "bun run scripts/build.ts",
-		"dev": "bun run src/index.ts",
-		"typecheck": "tsc --noEmit",
-		"lint": "biome check src",
-		"format": "biome check --write src",
-		"knip": "knip",
-		"test": "bun test --only-failures",
-		"test:verbose": "bun test",
-		"jscpd": "jscpd src",
-		"prepare": "lefthook install"
-	},
-	"dependencies": {
-		"@ai-sdk/anthropic": "^3.0.60",
-		"@ai-sdk/google": "^3.0.51",
-		"@ai-sdk/openai": "^3.0.45",
-		"@ai-sdk/openai-compatible": "^2.0.36",
-		"@modelcontextprotocol/sdk": "^1.27.1",
-		"ai": "^6.0.127",
-		"diff": "^8.0.3",
-		"yoctocolors": "^2.1.2",
-		"yoctomarkdown": "^0.0.7",
-		"zod": "^4.3.6"
-	},
-	"devDependencies": {
-		"@biomejs/biome": "^2.4.6",
-		"@types/bun": "latest",
-		"jscpd": "^4.0.8",
-		"knip": "^5.86.0",
-		"lefthook": "^2.1.4",
-		"typescript": "^5.9.3"
-	},
-	"knip": {
-		"entry": [
-			"src/mc-edit.ts"
-		]
-	},
-	"license": "MIT"
+  "name": "mini-coder",
+  "version": "0.2.1",
+  "description": "A small, fast CLI coding agent",
+  "module": "src/index.ts",
+  "type": "module",
+  "bin": {
+    "mc": "dist/mc.js",
+    "mc-edit": "dist/mc-edit.js"
+  },
+  "scripts": {
+    "prepare": "lefthook install",
+    "build": "bun run scripts/build.ts",
+    "dev": "bun run src/index.ts",
+    "format": "prettier --write --log-level warn .",
+    "check": "bun run prettier -c . && bun run typecheck && bun run lint && bun run knip && bun run jscpd && bun run test",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src",
+    "knip": "knip",
+    "test": "bun test --only-failures",
+    "test:verbose": "bun test",
+    "jscpd": "jscpd -s src"
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "^3.0.60",
+    "@ai-sdk/google": "^3.0.51",
+    "@ai-sdk/openai": "^3.0.45",
+    "@ai-sdk/openai-compatible": "^2.0.36",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "ai": "^6.0.127",
+    "diff": "^8.0.3",
+    "yoctocolors": "^2.1.2",
+    "yoctomarkdown": "^0.0.7",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.6",
+    "@types/bun": "latest",
+    "jscpd": "^4.0.8",
+    "knip": "^5.86.0",
+    "lefthook": "^2.1.4",
+    "prettier": "^3.8.1",
+    "typescript": "^5.9.3"
+  },
+  "knip": {
+    "entry": [
+      "src/mc-edit.ts"
+    ]
+  },
+  "license": "MIT"
 }