donebear 0.4.0 → 0.4.1
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/AGENTS.md +9 -9
- package/README.md +27 -17
- package/dist/cli.mjs +761 -302
- package/dist/cli.mjs.map +1 -1
- package/package.json +17 -5
package/AGENTS.md
CHANGED
|
@@ -6,12 +6,12 @@ Done Bear command-line interface for OAuth auth, workspace management, and task
|
|
|
6
6
|
|
|
7
7
|
Run from repo root:
|
|
8
8
|
|
|
9
|
-
- `npm run build --workspace=apps/cli
|
|
10
|
-
- `npm run dev --workspace=apps/cli
|
|
11
|
-
- `npm run lint
|
|
12
|
-
- `npm run check-types --workspace=apps/cli
|
|
13
|
-
- `npm run test --workspace=apps/cli
|
|
14
|
-
- `npm run lint:fix
|
|
9
|
+
- `npm run build --workspace=apps/cli`: build with tsdown
|
|
10
|
+
- `npm run dev --workspace=apps/cli`: watch build
|
|
11
|
+
- `npm run lint`: lint all workspaces (run from root)
|
|
12
|
+
- `npm run check-types --workspace=apps/cli`: TypeScript check
|
|
13
|
+
- `npm run test --workspace=apps/cli`: Vitest tests
|
|
14
|
+
- `npm run lint:fix`: format/autofix before commit
|
|
15
15
|
|
|
16
16
|
Run CLI locally from repo root:
|
|
17
17
|
|
|
@@ -112,9 +112,9 @@ src/
|
|
|
112
112
|
things-labels.ts # label normalization for import dedup
|
|
113
113
|
things-recurrence.ts # Things recurrence to RRule conversion
|
|
114
114
|
things-output.ts # import result summary formatting
|
|
115
|
-
model-id.ts #
|
|
115
|
+
model-id.ts # import + idempotency-key UUIDs (composite sync ids come from @donebear/sync-ids)
|
|
116
116
|
time-zone.ts # calendar date/time zone helpers
|
|
117
|
-
tests/ # Vitest
|
|
117
|
+
tests/ # Vitest: npm run test --workspace=apps/cli
|
|
118
118
|
```
|
|
119
119
|
|
|
120
120
|
## Gotchas
|
|
@@ -125,5 +125,5 @@ tests/ # Vitest — npm run test --workspace=apps/cli
|
|
|
125
125
|
- Local auth/context files are unencrypted and stored in the OS config dir (`DONEBEAR_CONFIG_DIR` can override).
|
|
126
126
|
- `task` commands accept ID prefixes; prefix resolution is workspace-scoped and may be ambiguous without `--workspace`.
|
|
127
127
|
- Use `--json` for scripts/automation and keep human-readable output as default.
|
|
128
|
-
- `spec` command returns JSON regardless of `--format
|
|
128
|
+
- `spec` command returns JSON regardless of `--format`; it is always machine-targeted.
|
|
129
129
|
- `context --markdown` uses `--markdown` (local flag), not the global `--format` option.
|
package/README.md
CHANGED
|
@@ -1,17 +1,20 @@
|
|
|
1
1
|
# donebear
|
|
2
2
|
|
|
3
|
-
Command-line interface for Done Bear.
|
|
3
|
+
Command-line interface for [Done Bear](https://donebear.com), a local-first GTD
|
|
4
|
+
task manager for the web, macOS, Windows, Linux, and
|
|
5
|
+
[iOS](https://donebear.com/ios).
|
|
4
6
|
|
|
5
|
-
|
|
7
|
+
Docs: [donebear.com/docs/cli](https://donebear.com/docs/cli) ·
|
|
8
|
+
Account: [app.donebear.com](https://app.donebear.com)
|
|
6
9
|
|
|
7
|
-
|
|
10
|
+
## Quick start
|
|
8
11
|
|
|
9
12
|
```bash
|
|
10
|
-
npm install
|
|
11
|
-
|
|
13
|
+
npm install -g donebear
|
|
14
|
+
donebear --help
|
|
12
15
|
```
|
|
13
16
|
|
|
14
|
-
|
|
17
|
+
Or run it without installing:
|
|
15
18
|
|
|
16
19
|
```bash
|
|
17
20
|
npx donebear --help
|
|
@@ -27,7 +30,7 @@ npx donebear task add "Ship donebear CLI" --when today
|
|
|
27
30
|
npx donebear task list
|
|
28
31
|
```
|
|
29
32
|
|
|
30
|
-
No environment variables are needed
|
|
33
|
+
No environment variables are needed; the CLI connects to production by default.
|
|
31
34
|
|
|
32
35
|
## Authentication
|
|
33
36
|
|
|
@@ -160,20 +163,20 @@ npx donebear task list --total # count only
|
|
|
160
163
|
| `project` | list | list, show, add, edit, done, archive, unarchive |
|
|
161
164
|
| `label` | list | list, show |
|
|
162
165
|
| `team` | list | list, show |
|
|
163
|
-
| `today` |
|
|
164
|
-
| `search` |
|
|
165
|
-
| `history` |
|
|
166
|
-
| `context` |
|
|
167
|
-
| `spec` |
|
|
168
|
-
| `api-key` |
|
|
169
|
-
| `import things` |
|
|
170
|
-
| `whoami` |
|
|
166
|
+
| `today` | n/a | List today's tasks |
|
|
167
|
+
| `search` | n/a | Search tasks by title or description |
|
|
168
|
+
| `history` | n/a | Workspace audit log |
|
|
169
|
+
| `context` | n/a | Workspace state snapshot (--markdown for prompts) |
|
|
170
|
+
| `spec` | n/a | CLI spec for agent discovery (no auth required) |
|
|
171
|
+
| `api-key` | n/a | create, list, revoke |
|
|
172
|
+
| `import things` | n/a | Import from Things 3 (--dry-run supported) |
|
|
173
|
+
| `whoami` | n/a | Print current user |
|
|
171
174
|
|
|
172
175
|
Run `npx donebear <command> --help` for full details.
|
|
173
176
|
|
|
174
177
|
## Environment variables
|
|
175
178
|
|
|
176
|
-
These are optional
|
|
179
|
+
These are optional; the CLI works out of the box for production use.
|
|
177
180
|
|
|
178
181
|
| Variable | Purpose | Default |
|
|
179
182
|
| ----------------------------------- | ------------------------------ | -------------------------- |
|
|
@@ -204,7 +207,14 @@ These are optional — the CLI works out of the box for production use.
|
|
|
204
207
|
|
|
205
208
|
## Development
|
|
206
209
|
|
|
207
|
-
|
|
210
|
+
Build from a checkout of the monorepo:
|
|
211
|
+
|
|
212
|
+
```bash
|
|
213
|
+
npm install
|
|
214
|
+
npm run build --workspace=apps/cli
|
|
215
|
+
```
|
|
216
|
+
|
|
217
|
+
Then, from repo root:
|
|
208
218
|
|
|
209
219
|
```bash
|
|
210
220
|
npm run lint --workspace=apps/cli
|