backlog.md 1.17.0 → 1.17.2

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 (2) hide show
  1. package/README.md +31 -23
  2. package/package.json +6 -6
package/README.md CHANGED
@@ -103,10 +103,16 @@ backlog browser --no-open
103
103
 
104
104
  ## 🔧 MCP Integration (Model Context Protocol)
105
105
 
106
- Connect Backlog.md to an MCP-compatible AI tool so it can launch `backlog mcp start` automatically whenever it needs project access.
106
+ The easiest way to connect Backlog.md to AI coding assistants like Claude Code, Codex, and Gemini CLI is via the MCP protocol.
107
+ You can run `backlog init` (even if you already initialized Backlog.md) to set up MCP integration automatically, or follow the manual steps below.
107
108
 
108
109
  ### Client guides
109
110
 
111
+ > [!IMPORTANT]
112
+ > When adding the MCP server manually, you should add some extra instructions in your CLAUDE.md/AGENTS.md files to inform the agent about Backlog.md.
113
+ > This step is not required when using `backlog init` as it adds these instructions automatically.
114
+ > Backlog.md's instructions for agents are available at [`/src/guidelines/mcp/agent-nudge.md`](/src/guidelines/mcp/agent-nudge.md).
115
+
110
116
  <details>
111
117
  <summary><strong>Claude Code</strong></summary>
112
118
 
@@ -120,7 +126,7 @@ Connect Backlog.md to an MCP-compatible AI tool so it can launch `backlog mcp st
120
126
  <summary><strong>Codex</strong></summary>
121
127
 
122
128
  ```bash
123
- codex mcp add backlog mcp start backlog
129
+ codex mcp add backlog backlog mcp start
124
130
  ```
125
131
 
126
132
  </details>
@@ -424,33 +430,35 @@ Perfect for sharing project status, creating reports, or storing snapshots in ve
424
430
 
425
431
  <!-- BOARD_START -->
426
432
 
427
- ## 📊 Backlog.md Project Status (v1.16.6)
433
+ ## 📊 Backlog.md Project Status (v1.17.1)
428
434
 
429
435
  This board was automatically generated by [Backlog.md](https://backlog.md)
430
436
 
431
- Generated on: 2025-10-17 19:30:49
437
+ Generated on: 2025-10-18 20:59:29
432
438
 
433
439
  | To Do | In Progress | Done |
434
440
  | --- | --- | --- |
435
- | **TASK-276** - Implement drag mode for TUI kanban board | **TASK-289** - Implement resource templates list handler to return empty list instead of error [@codex]<br>*#mcp #enhancement* | **TASK-299** - Fix MCP initialization for multiple AI coding agents (Codex, Gemini, Claude) [@codex]<br>*#mcp #init #multi-agent-support* |
436
- | **TASK-270** - Prevent command substitution in task creation inputs [@codex] | **TASK-280** - Fix TUI task list selection and detail pane synchronization bug [@codex]<br>*#bug #tui* | **TASK-298** - Fix document title renames [@codex] |
437
- | **TASK-268** - Show agent instruction version status [@codex] | └─ **TASK-24.1** - CLI: Kanban board milestone view [@codex] | **TASK-297** - Fix Windows MCP git fetch hang during task_create [@codex] |
438
- | **TASK-267** - Add agent instruction version metadata [@codex] | **TASK-273** - Refactor search [@codex]<br>*#core #search* | **TASK-290** - Improve MCP status field to use enum dropdown with config values [@codex] |
439
- | **TASK-260** - Web UI: Add filtering to All Tasks view [@codex]<br>*#web-ui #filters #ui* | | **TASK-288** - Fix browser UI error display and make priority optional<br>*#bug #ui #validation* |
440
- | **TASK-259** - Add task list filters for Status and Priority<br>*#tui #filters #ui* | | **TASK-284** - Simplify init flow; launch advanced settings via backlog config [@codex]<br>*#cli #init #config* |
441
- | **TASK-257** - Deep link URLs for tasks in board and list views | | **TASK-287** - Add MCP support for agent integration [@codex]<br>*#mcp #integration #agent* |
442
- | **TASK-200** - Add Claude Code integration with workflow commands during init<br>*#enhancement #developer-experience* | | **TASK-286** - Add npm script and shell script for updating bun.nix via Docker [@myself]<br>*#tooling #nix #ci* |
443
- | **TASK-244** - TUI: add live updates via watch in task list and kanban [@codex]<br>*#tui #watcher #enhancement* | | **TASK-285** - adjust z-index tooltip style |
444
- | **TASK-218** - Update documentation and tests for sequences<br>*#sequences #documentation #testing* | | **TASK-283** - Fix TUI board duplicating cards after external status changes [@codex] |
445
- | **TASK-217** - Create web UI for sequences with drag-and-drop<br>*#sequences #web-ui #frontend* | | **TASK-282** - Fix TUI detail pane loading state regression [@codex]<br>*#bug* |
446
- | └─ **TASK-217.03** - Sequences web UI: move tasks and update dependencies<br>*#sequences* | | **TASK-262** - TUI: Show all configured status columns in Kanban [@codex]<br>*#tui #board #kanban #config #parity* |
447
- | └─ **TASK-217.04** - Sequences web UI: tests<br>*#sequences* | | **TASK-281** - Fix backlog init skip option [@codex]<br>*#bug* |
448
- | └─ **TASK-217.02** - Sequences web UI: list sequences<br>*#sequences* | | **TASK-279** - Add cleanup functionality to web UI for managing completed tasks [@claude] |
449
- | **TASK-243** - Enable TUI task reordering with Shift+Arrow keys [@codex]<br>*#tui #ui #enhancement* | | **TASK-274** - Fix Kanban boards missing live updates [@claude] |
450
- | **TASK-240** - Improve binary resolution on Apple Silicon (Rosetta/arch mismatch) [@codex]<br>*#packaging #bug #macos* | | └─ **TASK-273.06** - 273.06: Web UI on centralized search [@codex]<br>*#web #search #ui* |
451
- | **TASK-239** - Feature: Auto-link tasks to documents/decisions + backlinks [@codex]<br>*#web #enhancement #docs* | | └─ **TASK-273.05** - 273.05: Server endpoints on shared store/search [@codex]<br>*#server #search #infra* |
452
- | **TASK-222** - Improve task and subtask visualization in web UI | | └─ **TASK-273.04** - 273.04: CLI & TUI search integration [@codex]<br>*#cli #tui #search* |
453
- | **TASK-208** - Add paste-as-markdown support in Web UI<br>*#web-ui #enhancement #markdown* | | |
441
+ | **TASK-276** - Implement drag mode for TUI kanban board | **TASK-289** - Implement resource templates list handler to return empty list instead of error [@codex]<br>*#mcp #enhancement* | **TASK-302** - Support flexible ID formats for tasks and docs [@codex] |
442
+ | **TASK-270** - Prevent command substitution in task creation inputs [@codex] | **TASK-280** - Fix TUI task list selection and detail pane synchronization bug [@codex]<br>*#bug #tui* | **TASK-301** - Feature: MCP document tools [@codex] |
443
+ | **TASK-268** - Show agent instruction version status [@codex] | └─ **TASK-24.1** - CLI: Kanban board milestone view [@codex] | **TASK-300** - Fix backlog init MCP registration flags for Claude and Gemini [@codex]<br>*#mcp #init* |
444
+ | **TASK-267** - Add agent instruction version metadata [@codex] | **TASK-273** - Refactor search [@codex]<br>*#core #search* | **TASK-299** - Fix MCP initialization for multiple AI coding agents (Codex, Gemini, Claude) [@codex]<br>*#mcp #init #multi-agent-support* |
445
+ | **TASK-260** - Web UI: Add filtering to All Tasks view [@codex]<br>*#web-ui #filters #ui* | | **TASK-298** - Fix document title renames [@codex] |
446
+ | **TASK-259** - Add task list filters for Status and Priority<br>*#tui #filters #ui* | | **TASK-297** - Fix Windows MCP git fetch hang during task_create [@codex] |
447
+ | **TASK-257** - Deep link URLs for tasks in board and list views | | **TASK-290** - Improve MCP status field to use enum dropdown with config values [@codex] |
448
+ | **TASK-200** - Add Claude Code integration with workflow commands during init<br>*#enhancement #developer-experience* | | **TASK-288** - Fix browser UI error display and make priority optional<br>*#bug #ui #validation* |
449
+ | **TASK-244** - TUI: add live updates via watch in task list and kanban [@codex]<br>*#tui #watcher #enhancement* | | **TASK-284** - Simplify init flow; launch advanced settings via backlog config [@codex]<br>*#cli #init #config* |
450
+ | **TASK-218** - Update documentation and tests for sequences<br>*#sequences #documentation #testing* | | **TASK-287** - Add MCP support for agent integration [@codex]<br>*#mcp #integration #agent* |
451
+ | **TASK-217** - Create web UI for sequences with drag-and-drop<br>*#sequences #web-ui #frontend* | | **TASK-286** - Add npm script and shell script for updating bun.nix via Docker [@myself]<br>*#tooling #nix #ci* |
452
+ | └─ **TASK-217.03** - Sequences web UI: move tasks and update dependencies<br>*#sequences* | | **TASK-285** - adjust z-index tooltip style |
453
+ | └─ **TASK-217.04** - Sequences web UI: tests<br>*#sequences* | | **TASK-283** - Fix TUI board duplicating cards after external status changes [@codex] |
454
+ | └─ **TASK-217.02** - Sequences web UI: list sequences<br>*#sequences* | | **TASK-282** - Fix TUI detail pane loading state regression [@codex]<br>*#bug* |
455
+ | **TASK-243** - Enable TUI task reordering with Shift+Arrow keys [@codex]<br>*#tui #ui #enhancement* | | **TASK-262** - TUI: Show all configured status columns in Kanban [@codex]<br>*#tui #board #kanban #config #parity* |
456
+ | **TASK-240** - Improve binary resolution on Apple Silicon (Rosetta/arch mismatch) [@codex]<br>*#packaging #bug #macos* | | **TASK-281** - Fix backlog init skip option [@codex]<br>*#bug* |
457
+ | **TASK-239** - Feature: Auto-link tasks to documents/decisions + backlinks [@codex]<br>*#web #enhancement #docs* | | **TASK-279** - Add cleanup functionality to web UI for managing completed tasks [@claude] |
458
+ | **TASK-222** - Improve task and subtask visualization in web UI | | **TASK-274** - Fix Kanban boards missing live updates [@claude] |
459
+ | **TASK-208** - Add paste-as-markdown support in Web UI<br>*#web-ui #enhancement #markdown* | | └─ **TASK-273.06** - 273.06: Web UI on centralized search [@codex]<br>*#web #search #ui* |
460
+ | | | └─ **TASK-273.05** - 273.05: Server endpoints on shared store/search [@codex]<br>*#server #search #infra* |
461
+ | | | └─ **TASK-273.04** - 273.04: CLI & TUI search integration [@codex]<br>*#cli #tui #search* |
454
462
 
455
463
  <!-- BOARD_END -->
456
464
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "backlog.md",
3
- "version": "1.17.0",
3
+ "version": "1.17.2",
4
4
  "files": [
5
5
  "cli.js",
6
6
  "resolveBinary.cjs",
@@ -13,11 +13,11 @@
13
13
  "backlog": "cli.js"
14
14
  },
15
15
  "optionalDependencies": {
16
- "backlog.md-linux-x64": "1.17.0",
17
- "backlog.md-linux-arm64": "1.17.0",
18
- "backlog.md-darwin-x64": "1.17.0",
19
- "backlog.md-darwin-arm64": "1.17.0",
20
- "backlog.md-windows-x64": "1.17.0"
16
+ "backlog.md-linux-x64": "1.17.2",
17
+ "backlog.md-linux-arm64": "1.17.2",
18
+ "backlog.md-darwin-x64": "1.17.2",
19
+ "backlog.md-darwin-arm64": "1.17.2",
20
+ "backlog.md-windows-x64": "1.17.2"
21
21
  },
22
22
  "scripts": {
23
23
  "postuninstall": "node postuninstall.cjs"