getnote-note Skill

Save, list, view, update, and delete notes in Get笔记.

Prerequisites

• getnote CLI installed and authenticated (getnote auth status should show "Authenticated")

Commands

Save a note

getnote save <url|text|image_path> [--title <title>] [--tag <tag>]...

• URL (http:// or https://) → link note:
• Share link (biji.com/note/share_note/ or d.biji.com/ short link) → sync, returns note_id directly, no polling needed
• Internal note link (biji.com/note/{note_id}) → this is the format for linking to another note inside note content; use it in content field when referencing other notes. If the current note will be shared publicly, prefer using the referenced note's share link (getnote note share <id>) instead of the internal link format
• Other URLs → async, auto-polls until done
• Local image path → image note (async, auto-polls until done)
• Otherwise → text note (sync)

getnote save https://example.com --title "Great article"
getnote save "Remember to review the docs" --tag work --tag important
getnote save ./screenshot.png --title "Design mockup"

In -o json mode, silently polls and returns the final note JSON (including title, content/summary, note_type, tags, created_at).

---

Track save task

getnote task <task_id>

Manually check progress of an async save task.

getnote task task_xyz789 -o json

Returns status (pending / processing / success / failed) and note_id when done.

---

List recent notes

getnote notes [--since-id <id>] [--all]

Returns 20 notes per page (fixed). No --limit flag.

getnote notes
getnote notes --all
getnote notes --since-id 1234567890
getnote notes -o json

Note types: plain_text / img_text / link / audio / meeting / local_audio / internal_record / class_audio / recorder_audio / recorder_flash_audio

---

Get note details

getnote note <id> [--field <field>]

Returns full note including content, tags, attachments. Use --field to extract a single value.

getnote note 1234567890
getnote note 1234567890 --field content
getnote note 1234567890 --field url
getnote note 1234567890 -o json

---

Update a note

getnote note update <id> [--title <title>] [--content <content>] [--tag <tags>]

getnote note update 1234567890 --title "Updated title"
getnote note update 1234567890 --tag "work,important"

⚠️ --tag replaces all tags. For partial tag changes use getnote tag add/remove. ⚠️ Content update only works on plain_text notes.

---

Delete a note

getnote note delete <id> [-y]

Moves note to trash.

getnote note delete 1234567890 -y

---

Share a note

getnote note share <id> [--exclude-audio]

Generates a public share link for a note. Idempotent — calling multiple times returns the same URL.

getnote note share 1234567890
getnote note share 1234567890 --exclude-audio
getnote note share 1234567890 -o json

Returns: share_url (e.g. https://biji.com/note/share_note/rBzdMlXrzgYVM)

---

Agent Usage Notes

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