Skip to content

Commit d4bee4e

Browse files
author
Walle
committed
release: v1.0.0 - fix skill JSON response structures, add browser open on auth login
1 parent bb18367 commit d4bee4e

5 files changed

Lines changed: 12 additions & 3 deletions

File tree

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@getnote/cli",
3-
"version": "0.1.6",
3+
"version": "1.0.0",
44
"description": "CLI tool for Get笔记 — manage notes and knowledge bases from the terminal",
55
"keywords": [
66
"getnote",

skills/getnote-kb/SKILL.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -97,6 +97,8 @@ getnote kb remove vnrOAaGY 1234567890
9797
## Agent Usage Notes
9898

9999
- Use `-o json` when parsing results programmatically.
100-
- Get `topic_id` from `getnote kbs -o json` (the `topic_id` field, not `id`).
100+
- `kbs -o json` returns `{"success":true,"data":{"topics":[...],"total":N}}`
101+
- `kb <topic_id> -o json` returns `{"success":true,"data":{"notes":[...],"has_more":...}}`
102+
- Get `topic_id` from `getnote kbs -o json``data.topics[].topic_id` field (not `id`).
101103
- `kb add` / `kb remove` accept multiple note IDs — prefer batching over multiple calls.
102104
- Exit code `0` = success; non-zero = error. Error details go to stderr.

skills/getnote-note/SKILL.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -146,6 +146,10 @@ getnote note delete 1234567890 -y
146146
## Agent Usage Notes
147147

148148
- Use `-o json` when parsing responses programmatically.
149+
- All JSON responses follow `{"success":true,"data":{...}}` structure, **except**:
150+
- `save` (text): returns `{"note_id":"..."}` directly
151+
- `save` (link/image): returns `{"data":{"tasks":[{"task_id":"..."}],...}}`
152+
- `task`: returns `{"success":true,"data":{"status":"...","note_id":"..."}}`
149153
- `notes` list returns **20 per page** (no `--limit`); paginate with `--since-id`.
150154
- Note IDs are int64 — always handle as strings to avoid precision loss in JavaScript.
151155
- Exit code `0` = success; non-zero = error. Error details go to stderr.

skills/getnote-search/SKILL.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,9 @@ getnote search "机器学习" --limit 5 -o json
4545
## Agent Usage Notes
4646

4747
- Use `-o json` when parsing results programmatically.
48-
- Get `topic_id` for `--kb` from `getnote kbs -o json`.
48+
- JSON response: `{"success":true,"results":[{"note_id":"...","title":"...","content":"...","created_at":"...","note_type":"..."}]}`
49+
- Note: `results` is at the top level, not nested under `data`.
50+
- Get `topic_id` for `--kb` from `getnote kbs -o json``data.topics[].topic_id`.
4951
- For `NOTE` type results, use `getnote note <note_id>` to get the full content.
5052
- Max `--limit` is 10; use `getnote notes` for browsing without a query.
5153
- Exit code `0` = success; non-zero = error. Error details go to stderr.

skills/getnote-tag/SKILL.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,7 @@ getnote tag remove 1896830231705320746 123
6767

6868
## Agent Usage Notes
6969

70+
- `tag list -o json` returns `{"note_id":"...","tags":[{"id":"...","name":"...","type":"..."}]}` (flat, no `success` wrapper).
7071
- `tag remove` takes a **numeric tag ID**, not a name — always call `tag list` first.
7172
- To replace all tags at once, use `getnote note update --tag "tag1,tag2"` instead.
7273
- Exit code `0` = success; non-zero = error. Error details go to stderr.

0 commit comments

Comments
 (0)