@hasna/todos 0.3.6 → 0.4.0

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
@@ -75,6 +75,36 @@ Or start manually via stdio:
75
75
  todos-mcp
76
76
  ```
77
77
 
78
+ ## Sync (Optional)
79
+
80
+ Claude supports a native task list. Other agents use JSON task lists under `~/.todos/agents/<agent>/<task_list_id>/`.
81
+
82
+ ```bash
83
+ todos sync --agent claude --task-list <id>
84
+ todos sync --agent codex --task-list default
85
+ todos sync --all --task-list <id>
86
+ todos sync --prefer local
87
+ ```
88
+
89
+ Env overrides:
90
+ - `TODOS_SYNC_AGENTS` (comma-separated list for `--all`)
91
+ - `TODOS_TASK_LIST_ID` or `TODOS_<AGENT>_TASK_LIST`
92
+ - `TODOS_AGENT_TASKS_DIR` or `TODOS_<AGENT>_TASKS_DIR`
93
+
94
+ Config file: `~/.todos/config.json`
95
+
96
+ ```json
97
+ {
98
+ "sync_agents": ["claude", "codex", "gemini"],
99
+ "task_list_id": "default",
100
+ "agent_tasks_dir": "/Users/you/.todos/agents",
101
+ "agents": {
102
+ "claude": { "task_list_id": "session-or-project-id" },
103
+ "codex": { "task_list_id": "default", "tasks_dir": "/Users/you/.todos/agents" }
104
+ }
105
+ }
106
+ ```
107
+
78
108
  ## CLI Commands
79
109
 
80
110
  | Command | Description |
@@ -112,9 +142,11 @@ completeTask(task.id);
112
142
  SQLite database with automatic location detection:
113
143
 
114
144
  1. `TODOS_DB_PATH` environment variable (`:memory:` for testing)
115
- 2. `.todos/todos.db` in current directory
145
+ 2. Nearest `.todos/todos.db` in current directory or any parent
116
146
  3. `~/.todos/todos.db` global fallback
117
147
 
148
+ Set `TODOS_DB_SCOPE=project` to force project-level DB at the git root (if found).
149
+
118
150
  ## Development
119
151
 
120
152
  ```bash