@togglhq/cli 1.5.26 → 1.5.28
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 +15 -15
- package/build/cli.js +1 -1
- package/build/index.js +1 -1
- package/build/{program-B03iyxXV.js → program-CwW_34U6.js} +8242 -8985
- package/build/program.js +1 -1
- package/package.json +5 -3
- package/skills/toggl-cli/reference/auth-environments-workspaces.md +1 -1
- package/skills/toggl-cli/reference/command-contract.md +14 -14
- package/skills/toggl-cli/reference/projects.md +2 -2
- package/skills/toggl-cli/reference/tasks.md +2 -2
- package/skills/toggl-cli/reference/troubleshooting.md +1 -1
- package/skills/toggl-cli/workflows/common-workflows.md +1 -1
- package/skills/toggl-cli/INTERNAL.md +0 -62
package/README.md
CHANGED
|
@@ -20,7 +20,7 @@ npx @togglhq/cli
|
|
|
20
20
|
toggl auth
|
|
21
21
|
```
|
|
22
22
|
|
|
23
|
-
Opens a browser for OAuth sign-in. On success, credentials are saved to `~/.toggl/focus-tools.json`. When `--profile` is omitted, the CLI saves the account under a name based on your account, such as `
|
|
23
|
+
Opens a browser for OAuth sign-in. On success, credentials are saved to `~/.toggl/focus-tools.json`. When `--profile` is omitted, the CLI saves the account under a name based on your account, such as `user-12345`, and makes it active.
|
|
24
24
|
|
|
25
25
|
**Options:**
|
|
26
26
|
|
|
@@ -38,9 +38,9 @@ Use profiles to switch between saved accounts and environments:
|
|
|
38
38
|
```bash
|
|
39
39
|
toggl profile list
|
|
40
40
|
toggl profile current
|
|
41
|
-
toggl profile switch
|
|
41
|
+
toggl profile switch user-12345
|
|
42
42
|
toggl profile switch # omit name in a TTY: pick from a menu or use the only profile
|
|
43
|
-
toggl profile remove
|
|
43
|
+
toggl profile remove user-12345
|
|
44
44
|
```
|
|
45
45
|
|
|
46
46
|
The active profile controls both the account and environment for later commands. You can still override it for one call with the global `--profile <name>` flag.
|
|
@@ -81,7 +81,7 @@ Many endpoints use two segments (`toggl tasks list`). Some use nested groups, in
|
|
|
81
81
|
- **`toggl organization …`** — organization APIs (not `toggl org …`; there is no `org` top-level command). Examples: `toggl organization invitations list`, `toggl organization members get`, `toggl organization workspaces list`.
|
|
82
82
|
- **`toggl shared …`** — shared workspace/org data routed through `@toggl/queries` helpers (status, holidays, working hours, time off). Example: `toggl shared status get`.
|
|
83
83
|
|
|
84
|
-
Core resource groups still include `tasks`, `projects`, `time-blocks`, `time-entries`, `statuses`, `users`, `tags`, `clients`, and others surfaced by
|
|
84
|
+
Core resource groups still include `tasks`, `projects`, `time-blocks`, `time-entries`, `statuses`, `users`, `tags`, `clients`, and others surfaced by the public command catalog. Some low-level endpoints are omitted from the CLI and MCP. Existing public command paths and operation IDs stay stable; use `toggl --help` and `toggl <group> --help` to explore what shipped.
|
|
85
85
|
|
|
86
86
|
**Typical entity commands:**
|
|
87
87
|
|
|
@@ -118,7 +118,7 @@ Each input field maps to a `--field-name` flag. Numeric values are coerced autom
|
|
|
118
118
|
|
|
119
119
|
```bash
|
|
120
120
|
toggl tasks get --task-id 12345
|
|
121
|
-
toggl tasks list --project-id 999 --status-id
|
|
121
|
+
toggl tasks list --project-id 999 --status-id 111222
|
|
122
122
|
toggl time-entries list --date-from 2025-01-01 --date-to 2025-01-07
|
|
123
123
|
toggl time-entries start --task-id 12345 --type activity
|
|
124
124
|
```
|
|
@@ -126,7 +126,7 @@ toggl time-entries start --task-id 12345 --type activity
|
|
|
126
126
|
For `update` commands, payload fields use a `--payload-<field>` prefix:
|
|
127
127
|
|
|
128
128
|
```bash
|
|
129
|
-
toggl tasks update --task-id 12345 --payload-name "New name" --payload-status-id
|
|
129
|
+
toggl tasks update --task-id 12345 --payload-name "New name" --payload-status-id 456789
|
|
130
130
|
toggl projects update --project-id 999 --payload-name "Renamed"
|
|
131
131
|
```
|
|
132
132
|
|
|
@@ -135,9 +135,9 @@ toggl projects update --project-id 999 --payload-name "Renamed"
|
|
|
135
135
|
Pass the full input as a JSON string:
|
|
136
136
|
|
|
137
137
|
```bash
|
|
138
|
-
toggl tasks list --data '{"project_id":
|
|
139
|
-
toggl tasks create --data '{"name": "Fix login bug", "project_id":
|
|
140
|
-
toggl tasks update --data '{"task_id": 12345, "payload": {"name": "Updated", "status_id":
|
|
138
|
+
toggl tasks list --data '{"project_id": 123456, "per_page": 50}'
|
|
139
|
+
toggl tasks create --data '{"name": "Fix login bug", "project_id": 123456}'
|
|
140
|
+
toggl tasks update --data '{"task_id": 12345, "payload": {"name": "Updated", "status_id": 456789}}'
|
|
141
141
|
```
|
|
142
142
|
|
|
143
143
|
### 3. `--data -` (stdin) or `--data-file <path>`
|
|
@@ -182,16 +182,16 @@ toggl time-blocks delete --task-id 12345 --time-block-id 67890 --yes
|
|
|
182
182
|
|
|
183
183
|
```bash
|
|
184
184
|
# List all tasks in a project
|
|
185
|
-
toggl tasks list --project-id
|
|
185
|
+
toggl tasks list --project-id 123456
|
|
186
186
|
|
|
187
187
|
# Get a single task
|
|
188
188
|
toggl tasks get --task-id 12345
|
|
189
189
|
|
|
190
190
|
# Create a task
|
|
191
|
-
toggl tasks create --data '{"name": "Write release notes", "project_id":
|
|
191
|
+
toggl tasks create --data '{"name": "Write release notes", "project_id": 123456}'
|
|
192
192
|
|
|
193
193
|
# Move task to "In Progress"
|
|
194
|
-
toggl tasks update --task-id 12345 --payload-status-id
|
|
194
|
+
toggl tasks update --task-id 12345 --payload-status-id 456789
|
|
195
195
|
|
|
196
196
|
# Delete a task (requires --yes)
|
|
197
197
|
toggl tasks delete --task-id 12345 --yes
|
|
@@ -201,9 +201,9 @@ toggl tasks delete --task-id 12345 --yes
|
|
|
201
201
|
|
|
202
202
|
```bash
|
|
203
203
|
toggl projects list
|
|
204
|
-
toggl projects get --project-id
|
|
205
|
-
toggl projects create --data '{"name": "Q3 Planning", "workspace_id":
|
|
206
|
-
toggl projects update --project-id
|
|
204
|
+
toggl projects get --project-id 123456
|
|
205
|
+
toggl projects create --data '{"name": "Q3 Planning", "workspace_id": 789012}'
|
|
206
|
+
toggl projects update --project-id 123456 --payload-name "Q3 Planning (archived)"
|
|
207
207
|
toggl projects delete --project-id 999 --yes
|
|
208
208
|
```
|
|
209
209
|
|
package/build/cli.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import { n as CommanderError, t as createProgram } from "./program-
|
|
2
|
+
import { n as CommanderError, t as createProgram } from "./program-CwW_34U6.js";
|
|
3
3
|
//#region src/cli.ts
|
|
4
4
|
try {
|
|
5
5
|
await createProgram({ enableUpdateNotification: true }).parseAsync(process.argv);
|
package/build/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import { t as createProgram } from "./program-
|
|
1
|
+
import { t as createProgram } from "./program-CwW_34U6.js";
|
|
2
2
|
export { createProgram };
|