taskchef 8.5.2 → 8.6.0

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "taskchef",
-  "version": "8.5.2",
+  "version": "8.6.0",
   "description": "Dispatch work from a data-only workspace to visible Codex project tasks.",
   "author": {
     "name": "Favo Yang",

package/README.md

@@ -47,6 +47,8 @@ every task.
 
 The screenshots in this walkthrough use illustrative demo data. Open the
 dashboard beside TaskChef master to see both tasks across your projects.
+In Codex, you can also call `open_taskchef_board` for a compact [sidebar app](docs/mcp-app.md)
+with a task board, task details, chat links, and confirmed manual status changes.
 **Board** groups tasks by **Working**, **Needs input**, **Completed**, and
 **Failed** so you can see their status at a glance.
 
@@ -146,6 +148,9 @@ takes precedence over its role preference.
 
 ## More detail
 
+Read the [frequently asked questions](https://favoyang.com/taskchef/#faq) for
+answers about delegation, the dashboard, model roles, and local data.
+
 The [advanced guide](docs/advanced-guide.md) covers project indexing, routing,
 task reporting, dashboard behavior, recovery, updates, and development. The
 [specification](docs/spec.md) and [workflows](docs/workflows.md) describe the

package/docs/mcp-app.md

@@ -0,0 +1,11 @@
+# TaskChef sidebar app
+
+Call `open_taskchef_board` in Codex to open the TaskChef MCP App in the sidebar. The app reads the same local workspace and task log as the web dashboard. It needs the TaskChef MCP server to be connected and an MCP Apps-capable Codex host.
+
+The sidebar uses the dashboard's task cards, horizontal board lanes, and detail view. Switch between **List** and **Board**. In List, filter by project, update window, and status; status counts reflect the selected project and window, and the summary reports visible tasks. Board shows all status lanes for the selected project and window. Task cards include request and result summaries, relative update times, reported work and usage summaries, and related GitHub links. Select a task for its usage, activity timeline, instruction, and metadata.
+
+**Open chat** opens a linked Codex thread, or the configured project when the task has no usable direct chat link. **Mark completed** and **Mark failed** require confirmation and use the same audited, conflict-checked manual transition as the web dashboard. The app refreshes every five seconds and offers manual refresh. A refresh does not replace a newer selection or a changed task with an older response.
+
+The UI is a bundled `ui://taskchef/task-board/v2` MCP resource. Its read, open, and transition calls are app-only tools on the existing stdio MCP server. The iframe does not read files or contact the local HTTP dashboard. The web dashboard remains available separately.
+
+For development, run `npm run build:mcp-app` after editing `src/mcp-app/react/`. The generated single-file resource is `src/mcp-app/dist/index.html`. Run `npm run check:mcp-app` and `npm test` before release. Reopen the sidebar after rebuilding to load the new resource.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taskchef",
-  "version": "8.5.2",
+  "version": "8.6.0",
   "description": "A non-blocking interactive dispatcher for visible Codex tasks.",
   "license": "Apache-2.0",
   "author": "Favo Yang",
@@ -28,6 +28,7 @@
     "docs/workflows.md",
     "docs/dashboard-lifecycle.md",
     "docs/dashboard-ui.md",
+    "docs/mcp-app.md",
     "docs/firstmate-taskchef-comparison.md",
     "docs/images/dashboard-identity.jpg",
     "docs/images/ccusage-token-consumption.png",
@@ -58,6 +59,7 @@
     "node": ">=18"
   },
   "devDependencies": {
+    "@modelcontextprotocol/ext-apps": "^1.1.2",
     "@testing-library/jest-dom": "6.8.0",
     "@testing-library/react": "16.3.0",
     "@testing-library/user-event": "14.6.1",
@@ -70,6 +72,7 @@
     "mermaid": "^11.17.0",
     "typescript": "5.9.2",
     "vite": "6.4.3",
+    "vite-plugin-singlefile": "^2.3.0",
     "vitest": "3.2.7",
     "yaml": "^2.9.0"
   },
@@ -77,7 +80,9 @@
     "benchmark:dispatch": "node scripts/benchmark-dispatch-prepare.js",
     "benchmark:e2e": "node scripts/e2e-benchmark.js",
     "build:dashboard": "vite build --config vite.config.ts",
+    "build:mcp-app": "vite build --config vite.mcp-app.config.ts",
     "check:dashboard": "tsc --noEmit -p tsconfig.dashboard.json",
+    "check:mcp-app": "tsc --noEmit -p tsconfig.mcp-app.json",
     "preview:dashboard": "node scripts/preview-dashboard.js",
     "test": "npm run test:node && npm run test:dashboard",
     "test:node": "node --test tests/*.test.js",
@@ -100,6 +105,6 @@
     "zod"
   ],
   "optionalDependencies": {
-    "ccusage": "20.0.20"
+    "ccusage": "20.0.24"
   }
 }