@hasna/todos 0.9.15 → 0.9.17

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.
package/README.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # @hasna/todos
2
2
 
3
+ [![npm version](https://img.shields.io/npm/v/@hasna/todos)](https://www.npmjs.com/package/@hasna/todos)
4
+ [![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
5
+ [![Tests](https://img.shields.io/badge/tests-295%20passing-brightgreen)]()
6
+
3
7
  Universal task management for AI coding agents. CLI + MCP server + library, all sharing a single SQLite database.
4
8
 
5
9
  ## Features
@@ -183,6 +187,50 @@ todos-mcp
183
187
  | `todos://agents` | All registered agents |
184
188
  | `todos://task-lists` | All task lists |
185
189
 
190
+ ## Web Dashboard
191
+
192
+ Start the web dashboard to manage tasks visually:
193
+
194
+ ```bash
195
+ todos serve
196
+ # or
197
+ todos-serve --port 19427
198
+ ```
199
+
200
+ Features:
201
+ - **Dashboard** — stats cards, completion rate, recent activity
202
+ - **Tasks** — data table with search, filters, sorting, pagination, kanban board view
203
+ - **Projects** — project management with task breakdown
204
+ - **Agents** — agent monitoring with completion rates, online status, role management
205
+ - **Help** — keyboard shortcuts, CLI reference, MCP configuration
206
+
207
+ The dashboard auto-refreshes every 30 seconds, supports dark mode, and includes keyboard shortcuts (`/` search, `n` new task, `0-4` navigate pages).
208
+
209
+ ## REST API
210
+
211
+ When running `todos serve`, the following REST API is available:
212
+
213
+ | Method | Endpoint | Description |
214
+ |--------|----------|-------------|
215
+ | GET | `/api/stats` | Dashboard statistics |
216
+ | GET | `/api/tasks` | List tasks (supports `?status=`, `?project_id=`, `?limit=`) |
217
+ | POST | `/api/tasks` | Create a task |
218
+ | GET | `/api/tasks/:id` | Get task details |
219
+ | PATCH | `/api/tasks/:id` | Update a task |
220
+ | DELETE | `/api/tasks/:id` | Delete a task |
221
+ | POST | `/api/tasks/:id/start` | Start a task |
222
+ | POST | `/api/tasks/:id/complete` | Complete a task |
223
+ | POST | `/api/tasks/bulk` | Bulk operations (start, complete, delete) |
224
+ | GET | `/api/tasks/export?format=csv` | Export tasks as CSV |
225
+ | GET | `/api/tasks/export?format=json` | Export tasks as JSON |
226
+ | GET | `/api/projects` | List projects |
227
+ | POST | `/api/projects` | Create a project |
228
+ | DELETE | `/api/projects/:id` | Delete a project |
229
+ | GET | `/api/agents` | List agents |
230
+ | POST | `/api/agents` | Register an agent |
231
+ | PATCH | `/api/agents/:id` | Update an agent |
232
+ | DELETE | `/api/agents/:id` | Delete an agent |
233
+
186
234
  ## Sync
187
235
 
188
236
  Bidirectional sync with agent-specific task lists.
@@ -338,8 +386,8 @@ SQLite with automatic location detection:
338
386
  ## Development
339
387
 
340
388
  ```bash
341
- git clone https://github.com/hasna/todos.git
342
- cd todos
389
+ git clone https://github.com/hasna/open-todos.git
390
+ cd open-todos
343
391
  bun install
344
392
  bun test # Run 172 tests
345
393
  bun run typecheck # TypeScript checking