backlog.md-darwin-arm64 1.2.6 → 1.2.7

package/README.md

@@ -2,7 +2,7 @@
 <p align="center">Markdown‑native Task Manager &amp; Kanban visualizer for any Git repository</p>
 
 <p align="center">
-<code>npm i -g backlog.md</code> or <code>bun add -g backlog.md</code>
+<code>npm i -g backlog.md</code> or <code>bun add -g backlog.md</code> or <code>brew install backlog-md</code>
 </p>
 
 ![Backlog demo GIF using: backlog board](./.github/backlog.gif)
@@ -90,7 +90,25 @@ The web interface provides:
 
 ---
 
-## CLI reference (essentials)
+## CLI reference
+
+### Project Setup
+
+| Action      | Example                                              |
+|-------------|------------------------------------------------------|
+| Initialize project | `backlog init [project-name]` (creates backlog structure with interactive configuration) |
+| Re-initialize | `backlog init` (preserves existing config, allows updates) |
+
+The `backlog init` command provides comprehensive project setup with interactive prompts for:
+- **Project name** - identifier for your backlog
+- **Auto-commit** - whether to automatically commit task changes to git
+- **Default editor** - editor command for opening tasks (detects from environment)
+- **Remote operations** - enable/disable fetching tasks from remote branches
+- **Web UI settings** - port and browser auto-open preferences
+
+When re-initializing an existing project, all current configuration values are preserved and pre-populated in prompts, allowing you to update only what you need.
+
+### Task Management
 
 | Action      | Example                                              |
 |-------------|------------------------------------------------------|
@@ -105,7 +123,6 @@ The web interface provides:
 | Create with notes | `backlog task create "Feature" --notes "Started initial research"` |
 | Create with deps | `backlog task create "Feature" --dep task-1,task-2` |
 | Create sub task | `backlog task create -p 14 "Add Login with Google"`|
-| Create draft | `backlog task create "Feature" --draft`             |
 | Create (all options) | `backlog task create "Feature" -d "Description" -a @sara -s "To Do" -l auth --priority high --ac "Must work" --notes "Initial setup done" --dep task-1 -p 14` |
 | List tasks  | `backlog task list [-s <status>] [-a <assignee>] [-p <parent>]` |
 | List by parent | `backlog task list --parent 42` or `backlog task list -p task-42` |
@@ -117,17 +134,66 @@ The web interface provides:
 | Add notes   | `backlog task edit 7 --notes "Completed X, working on Y"` |
 | Add deps    | `backlog task edit 7 --dep task-1 --dep task-2`     |
 | Archive     | `backlog task archive 7`                             |
+
+### Draft Workflow
+
+| Action      | Example                                              |
+|-------------|------------------------------------------------------|
+| Create draft | `backlog task create "Feature" --draft`             |
 | Draft flow  | `backlog draft create "Spike GraphQL"` → `backlog draft promote 3.1` |
 | Demote to draft| `backlog task demote <id>` |
-| Cleanup done tasks | `backlog cleanup` (move old completed tasks to completed folder) |
+
+### Board Operations
+
+| Action      | Example                                              |
+|-------------|------------------------------------------------------|
 | Kanban board      | `backlog board` (interactive UI, press 'E' to edit in editor) |
 | Export board | `backlog board export [file]` (exports Kanban board to markdown) |
+
+### Web Interface
+
+| Action      | Example                                              |
+|-------------|------------------------------------------------------|
 | Web interface | `backlog browser` (launches web UI on port 6420) |
 | Web custom port | `backlog browser --port 8080 --no-open` |
+
+### Configuration
+
+| Action      | Example                                              |
+|-------------|------------------------------------------------------|
 | Config editor | `backlog config set defaultEditor "code --wait"` |
 | Enable auto-commit | `backlog config set autoCommit true` |
 | View config | `backlog config list` |
 
+### Documentation
+
+| Action      | Example                                              |
+|-------------|------------------------------------------------------|
+| Create doc | `backlog doc create "API Guidelines"` |
+| Create with path | `backlog doc create "Setup Guide" -p guides/setup` |
+| Create with type | `backlog doc create "Architecture" -t technical` |
+| List docs | `backlog doc list` |
+| View doc | `backlog doc view doc-1` |
+
+### Decisions
+
+| Action      | Example                                              |
+|-------------|------------------------------------------------------|
+| Create decision | `backlog decision create "Use PostgreSQL for primary database"` |
+| Create with status | `backlog decision create "Migrate to TypeScript" -s proposed` |
+
+### Agent Instructions
+
+| Action      | Example                                              |
+|-------------|------------------------------------------------------|
+| Update agent files | `backlog agents --update-instructions` (updates .cursorrules, CLAUDE.md, AGENTS.md, GEMINI.md, .github/copilot-instructions.md) |
+
+### Maintenance
+
+| Action      | Example                                              |
+|-------------|------------------------------------------------------|
+| Cleanup done tasks | `backlog cleanup` (move old completed tasks to completed folder) |
+
 Full help: `backlog --help`
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backlog.md-darwin-arm64",
-  "version": "1.2.6",
+  "version": "1.2.7",
   "os": ["darwin"],
   "cpu": ["arm64"],
   "bin": {"backlog": "backlog"},