Read and search

List, search, and print notes and their blocks

Reading never changes the vault. The examples run in a terminal opened in the vault folder; see choose a vault.

List notes

zyler ls
note_osk58obce0sd  Project plan
note_wow31iq9tdc7  Weekly review

Name a note to list only its direct children:

zyler ls "Project plan"

ls shows 100 notes at a time. Add --all for the whole vault, or --limit and the --cursor it prints to page through.

zyler search outline
note_osk58obce0sd  Project plan
    …s Ship the help center Write the CLI guides Tasks Draft the outline Pick a docs site

Search looks in titles and bodies and shows up to 20 hits; --limit changes that.

zyler cat "Project plan"
## Goals

- Ship the help center
- Write the CLI guides

## Tasks

- [ ] Draft the outline
- [x] Pick a docs site

cat prints Markdown in the same form every writing command accepts. To save it as a file, redirect it: zyler cat "Project plan" > plan.md. The shell overwrites an existing file with >.

See a note's blocks

Each paragraph, heading, list item, and other block has an id. Editing commands use these ids.

zyler blocks "Project plan"
oKABYuaq  heading     Goals
TddkAhJJ  bulletList  Ship the help center
F4YyvQo3  bulletList  Write the CLI guides
HGT6GXvW  heading     Tasks
t6Yc_-hS  taskList    Draft the outline
7TWmUygS  taskList    Pick a docs site

Show one block in full:

zyler block "Project plan" t6Yc_-hS
t6Yc_-hS  taskList
- [ ] Draft the outline

Output for programs

Add --json before or after the command to get one JSON object on every outcome, errors included:

zyler --json ls
{
  "ok": true,
  "vault": { "root": "/path/to/My vault", "source": "cwd-ancestor" },
  "notes": [
    { "noteId": "note_osk58obce0sd", "title": "Project plan", "parentId": null,
      "updatedAt": "2026-11-10T10:25:04.383Z", "locked": false }
  ],
  "total": 1
}

cat, blocks, and block also report the note's repositoryRevision, which keeps an edit from overwriting a newer one; see use with an AI assistant.

Edit this guide on GitHub