backlog.md 1.17.1 → 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 +30 -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,34 @@ 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.17.0)
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 21:48:02
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-301** - Feature: MCP document tools [@codex] |
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-300** - Fix backlog init MCP registration flags for Claude and Gemini [@codex]<br>*#mcp #init* |
437
- | **TASK-268** - Show agent instruction version status [@codex] | └─ **TASK-24.1** - CLI: Kanban board milestone view [@codex] | **TASK-299** - Fix MCP initialization for multiple AI coding agents (Codex, Gemini, Claude) [@codex]<br>*#mcp #init #multi-agent-support* |
438
- | **TASK-267** - Add agent instruction version metadata [@codex] | **TASK-273** - Refactor search [@codex]<br>*#core #search* | **TASK-298** - Fix document title renames [@codex] |
439
- | **TASK-260** - Web UI: Add filtering to All Tasks view [@codex]<br>*#web-ui #filters #ui* | | **TASK-297** - Fix Windows MCP git fetch hang during task_create [@codex] |
440
- | **TASK-259** - Add task list filters for Status and Priority<br>*#tui #filters #ui* | | **TASK-290** - Improve MCP status field to use enum dropdown with config values [@codex] |
441
- | **TASK-257** - Deep link URLs for tasks in board and list views | | **TASK-288** - Fix browser UI error display and make priority optional<br>*#bug #ui #validation* |
442
- | **TASK-200** - Add Claude Code integration with workflow commands during init<br>*#enhancement #developer-experience* | | **TASK-284** - Simplify init flow; launch advanced settings via backlog config [@codex]<br>*#cli #init #config* |
443
- | **TASK-244** - TUI: add live updates via watch in task list and kanban [@codex]<br>*#tui #watcher #enhancement* | | **TASK-287** - Add MCP support for agent integration [@codex]<br>*#mcp #integration #agent* |
444
- | **TASK-218** - Update documentation and tests for sequences<br>*#sequences #documentation #testing* | | **TASK-286** - Add npm script and shell script for updating bun.nix via Docker [@myself]<br>*#tooling #nix #ci* |
445
- | **TASK-217** - Create web UI for sequences with drag-and-drop<br>*#sequences #web-ui #frontend* | | **TASK-285** - adjust z-index tooltip style |
446
- | └─ **TASK-217.03** - Sequences web UI: move tasks and update dependencies<br>*#sequences* | | **TASK-283** - Fix TUI board duplicating cards after external status changes [@codex] |
447
- | └─ **TASK-217.04** - Sequences web UI: tests<br>*#sequences* | | **TASK-282** - Fix TUI detail pane loading state regression [@codex]<br>*#bug* |
448
- | └─ **TASK-217.02** - Sequences web UI: list sequences<br>*#sequences* | | **TASK-262** - TUI: Show all configured status columns in Kanban [@codex]<br>*#tui #board #kanban #config #parity* |
449
- | **TASK-243** - Enable TUI task reordering with Shift+Arrow keys [@codex]<br>*#tui #ui #enhancement* | | **TASK-281** - Fix backlog init skip option [@codex]<br>*#bug* |
450
- | **TASK-240** - Improve binary resolution on Apple Silicon (Rosetta/arch mismatch) [@codex]<br>*#packaging #bug #macos* | | **TASK-279** - Add cleanup functionality to web UI for managing completed tasks [@claude] |
451
- | **TASK-239** - Feature: Auto-link tasks to documents/decisions + backlinks [@codex]<br>*#web #enhancement #docs* | | **TASK-274** - Fix Kanban boards missing live updates [@claude] |
452
- | **TASK-222** - Improve task and subtask visualization in web UI | | └─ **TASK-273.06** - 273.06: Web UI on centralized search [@codex]<br>*#web #search #ui* |
453
- | **TASK-208** - Add paste-as-markdown support in Web UI<br>*#web-ui #enhancement #markdown* | | └─ **TASK-273.05** - 273.05: Server endpoints on shared store/search [@codex]<br>*#server #search #infra* |
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* |
454
461
  | | | └─ **TASK-273.04** - 273.04: CLI & TUI search integration [@codex]<br>*#cli #tui #search* |
455
462
 
456
463
  <!-- BOARD_END -->
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "backlog.md",
3
- "version": "1.17.1",
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.1",
17
- "backlog.md-linux-arm64": "1.17.1",
18
- "backlog.md-darwin-x64": "1.17.1",
19
- "backlog.md-darwin-arm64": "1.17.1",
20
- "backlog.md-windows-x64": "1.17.1"
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"