getnote-note Skill

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>]...

--title

--tag

• URL (

  http://

  or

  https://

  ) → link note (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"

-o json

title

content

note_type

tags

created_at

Track save task

getnote task <task_id>

getnote task task_xyz789 -o json

status

pending

processing

success

failed

note_id

List recent notes

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

--limit

--since-id

--all

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

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>]

--field

--field

id

title

content

type

created_at

updated_at

url

excerpt

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>]

--title

--content

--tag

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]

getnote note delete 1234567890 -y

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

    (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.