rcllr write

Write one file from Markdown on stdin, no JSON.

rcllr write <path> --expected REV [options]

Metadata comes from the frontmatter. A new topic needs a README in the same package: use ingest for that.

Examples

rcllr write notes/topic.md --scope work --expected new <<'EOF'
---
key_fact: Proven statement
aliases: [topic]
---

# Topic

Content
EOF
rcllr write bookmarks/ai.md --expected 9f4a55b37576 --append <<'EOF'
## Title
- URL: https://example.org
EOF

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

--expected REV

new for new files, otherwise rev from read/context.

--append

Append stdin to the end of the file.

--input PATH

Markdown file; - or no value reads stdin.

--dry-run

Validate and show changes; save nothing.

--message TEXT

Commit subject for this save, one line (default: repo.commit_message).

Global options for every command: see all commands.