rcllr read

Read a note, a line range or a section.

rcllr read <path> [options]

Without --start, output begins after the frontmatter; its key fields appear in the header line. --start 1 shows the whole frontmatter. If --end lies before the first body line, output starts at line 1.

Examples

rcllr read notes/topic.md
rcllr read notes/topic.md --end 3
rcllr read notes/topic.md --section "Open questions" --json

Arguments

<path>

Path relative to the brain, e.g. notes/topic.md.

Access

--scope SCOPE

A scope from rcllr.toml, or the all-scopes keyword (default: scopes.query_default).

--topic TOPIC

Limit access to this topic folder.

--allow-sensitive PATH

Release a sensitive path. Only when the user named it in the current prompt.

Output

--json

Print the result as compact JSON.

--max-chars N

Maximum output length in characters (500 to 20000, default: limits.max_chars).

Options

--start N

First line (physical line number).

--end N

Last line (inclusive).

--section HEADING

Read an original section by its unique heading.

Global options for every command: see all commands.