Flag	Description
`--title`	Optional title
`--tag`	Tag to apply; may be repeated

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.

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

`--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
`web_content`	Full web page content (link notes only)
`source`	Note source (e.g. `openapi`, `manual`)
`tags`	Comma-separated tag names

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

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"

⚠️ --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.

getnote-note

getnote-note Skill

Prerequisites

Commands

Save a note

More from iswalle/getnote-cli

getnote-auth

getnote-search

getnote-kb

getnote-tag