getnote-note Skill
Save, list, view, update, and delete notes in Get笔记.
Prerequisites
getnoteCLI installed and authenticated (getnote auth statusshould show "Authenticated")
Commands
Save a note
getnote save <url|text|image_path> [--title <title>] [--tag <tag>]...| Flag | Description |
|---|---|
--title | Optional title |
--tag | Tag to apply; may be repeated |
- URL (
http://orhttps://) → 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 jsonReturns 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.
| Flag | Description |
|---|---|
--since-id | Pagination cursor (last note ID seen) |
--all | Fetch all notes (auto-paginate, streams output) |
getnote notes
getnote notes --all
getnote notes --since-id 1234567890
getnote notes -o jsonNote 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.
--field values | Description |
|---|---|
id | Note ID |
title | Title |
content | Content / AI summary |
type | Note type |
created_at | Creation time |
updated_at | Last updated time |
url | Source URL (link notes) |
excerpt | Excerpt |
getnote note 1234567890
getnote note 1234567890 --field content
getnote note 1234567890 --field url
getnote note 1234567890 -o jsonUpdate a note
getnote note update <id> [--title <title>] [--content <content>] [--tag <tags>]| Flag | Description |
|---|---|
--title | New title |
--content | New content (plain_text notes only) |
--tag | Comma-separated tags — replaces all existing tags |
getnote note update 1234567890 --title "Updated title"
getnote note update 1234567890 --tag "work,important"⚠️--tagreplaces all tags. For partial tag changes usegetnote tag add/remove. ⚠️ Content update only works onplain_textnotes.
Delete a note
getnote note delete <id> [-y]Moves note to trash.
getnote note delete 1234567890 -yShare 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 jsonReturns: share_url (e.g. https://biji.com/note/share_note/rBzdMlXrzgYVM)
Agent Usage Notes
- Use
-o jsonwhen 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":"..."}}
noteslist 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.