mini-coder 0.0.14 → 0.0.16

package/docs/chatgpt-subscription-auth.md

@@ -0,0 +1,68 @@
+# ChatGPT/Codex subscription auth notes
+
+mini-coder does **not** currently support logging in with a ChatGPT Plus/Pro/Codex subscription.
+
+## Why
+
+We looked at two implementations:
+
+- OpenCode in `/tmp/opencode-src`
+- official Codex in `/tmp/openai-codex/codex-rs`
+
+Both rely on OpenAI **first-party/private** auth and backend APIs rather than a documented public developer API.
+
+## What those implementations do
+
+### Auth
+
+They use OAuth-like flows against `https://auth.openai.com`, including:
+
+- browser login with PKCE and a localhost callback server
+- device-code / headless login
+- refresh tokens via `POST /oauth/token`
+
+Both also rely on a hardcoded first-party client id embedded in their source trees.
+
+Examples:
+
+- official Codex: `/tmp/openai-codex/codex-rs/core/src/auth.rs`
+- OpenCode: `/tmp/opencode-src/packages/opencode/src/plugin/codex.ts`
+
+### Runtime API
+
+After login, requests are sent to ChatGPT backend endpoints such as:
+
+- `https://chatgpt.com/backend-api/codex`
+- `https://chatgpt.com/backend-api/codex/responses`
+
+with headers like:
+
+- `Authorization: Bearer <oauth access token>`
+- `ChatGPT-Account-Id: <account id>`
+
+Examples:
+
+- official Codex: `/tmp/openai-codex/codex-rs/core/src/model_provider_info.rs`
+- official Codex headers: `/tmp/openai-codex/codex-rs/backend-client/src/client.rs`
+- OpenCode rewrite layer: `/tmp/opencode-src/packages/opencode/src/plugin/codex.ts`
+
+## Why mini-coder is not adopting this
+
+- It depends on undocumented/private auth endpoints.
+- It depends on a hardcoded first-party client id.
+- It depends on private ChatGPT backend routes.
+- Browser login would require running a local callback server.
+- Even the official Codex source does not expose a clean public API-based alternative here.
+
+## Future stance
+
+We may revisit support if OpenAI exposes a stable, documented path for:
+
+- ChatGPT subscription login for third-party tools, or
+- a public Codex/ChatGPT backend API intended for external clients
+
+Until then, mini-coder only supports providers with clearer public integration paths.
+
+## Note
+
+If you want a supported hosted integration instead of ChatGPT subscription auth, mini-coder already supports OpenCode Zen via `OPENCODE_API_KEY`. See the existing `zen/<model>` provider path.

package/docs/custom-agents.md

@@ -46,6 +46,8 @@ into the conversation.
 |---|---|---|
 | `description` | No | Shown in `/help`. Defaults to filename. |
 | `model` | No | Override the active model for this agent. |
+| `mode` | No | `primary` — interactive only (via `/agent <name>`); `subagent` — callable via the `subagent` tool only (default); `all` — both. |
+
 
 The markdown body (after frontmatter) is the agent's system prompt.
 

package/docs/custom-commands.md

@@ -20,7 +20,8 @@ Create a markdown file. The filename becomes the command name.
 ```md
 ---
 description: Summarise what changed since yesterday
-model: zen/claude-3-5-haiku
+model: zen/claude-haiku-4-5
+
 ---
 
 Run `!`git log --oneline --since=yesterday`` and summarise the changes
@@ -38,8 +39,11 @@ Then in the REPL:
 | Field | Required | Description |
 |---|---|---|
 | `description` | No | Shown in `/help`. Defaults to the command name. |
-| `model` | No | Override the active model for this command (subagent execution). |
-| `execution` | No | Where the command runs: `subagent` (default) or `inline`. |
+| `model` | No | Override the active model for this command (only applies when `context: fork`). |
+| `context` | No | Set to `fork` to run the command as an isolated subagent; default runs inline. |
+| `subtask` | No | Set to `true` to force subagent execution (OpenCode-compatible alias for `context: fork`). |
+| `agent` | No | Run the command under a named agent's system prompt (only applies when `context: fork`). |
+
 
 
 ## Arguments
@@ -51,7 +55,8 @@ Use `$ARGUMENTS` for the full argument string, or `$1`, `$2`, … `$9` for indiv
 ```md
 ---
 description: Search the codebase for a topic
-model: zen/claude-3-5-haiku
+model: zen/claude-haiku-4-5
+
 ---
 
 Search the codebase for: $ARGUMENTS
@@ -111,7 +116,8 @@ lightweight tasks regardless of what the session is currently set to.
 ```md
 ---
 description: Quick grep for a symbol
-model: zen/claude-3-5-haiku
+model: zen/claude-haiku-4-5
+
 ---
 
 Find all usages of $ARGUMENTS across the codebase using grep and glob.
@@ -120,31 +126,14 @@ List each occurrence with file path and line number. No explanations needed.
 
 Large models for deep analysis, small models for search and lookup.
 
-## Execution mode
-
-By default, commands run with `execution: subagent` (even if `execution`
-is omitted).
-
-Use `execution: inline` to run the command in the main agent context
-instead of spawning a subagent worktree.
-
-```md
----
-description: Safe release flow
-execution: inline
----
-
-Run the release steps in this main repo checkout.
-```
-
-Use `inline` for repo-sensitive workflows (like release flows) where branch
-context must be exactly the current session branch.
-
 
 ## Precedence
 
-Custom commands shadow built-ins. If you create `.agents/commands/review.md`
-it will replace the built-in `/review` for that project.
+Custom commands shadow built-ins. If you create `.agents/commands/plan.md`
+it will replace the built-in `/plan` for that project. The global `/review`
+command (auto-created at `~/.agents/commands/review.md` on first run) works
+the same way — a local `.agents/commands/review.md` will override it.
+
 
 ## Listing commands
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mini-coder",
-	"version": "0.0.14",
+	"version": "0.0.16",
 	"description": "A small, fast CLI coding agent",
 	"module": "src/index.ts",
 	"type": "module",
@@ -13,24 +13,28 @@
 		"typecheck": "tsc --noEmit",
 		"lint": "biome check src",
 		"format": "biome format --write src",
-		"test": "bun test"
+		"knip": "knip",
+		"test": "bun test --only-failures",
+		"test:verbose": "bun test",
+		"jscpd": "jscpd src"
 	},
 	"dependencies": {
-		"@ai-sdk/anthropic": "^3.0.46",
-		"@ai-sdk/google": "^3.0.30",
-		"@ai-sdk/openai": "^3.0.30",
-		"@ai-sdk/openai-compatible": "^2.0.30",
-		"@modelcontextprotocol/sdk": "^1.26.0",
-		"ai": "^6.0.94",
+		"@ai-sdk/anthropic": "^3.0.58",
+		"@ai-sdk/google": "^3.0.43",
+		"@ai-sdk/openai": "^3.0.41",
+		"@ai-sdk/openai-compatible": "^2.0.35",
+		"@modelcontextprotocol/sdk": "^1.27.1",
+		"ai": "^6.0.116",
 		"ignore": "^7.0.5",
-		"ollama-ai-provider": "^1.2.0",
-		"yoctocolors": "^2.1.1",
+		"yoctocolors": "^2.1.2",
 		"zod": "^4.3.6"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "^1.9.4",
+		"@biomejs/biome": "^2.4.6",
 		"@types/bun": "latest",
-		"typescript": "^5.8.3"
+		"jscpd": "^4.0.8",
+		"knip": "^5.86.0",
+		"typescript": "^5.9.3"
 	},
 	"license": "MIT"
 }