rcllr ingest

Write several files atomically from a JSON package.

rcllr ingest [options]

Index, commit and push run automatically. Per entry exactly one of: content (whole file), replace (text pairs) or append (text at the end). expected: null for new files, otherwise rev from read/context (12 characters are enough).

Examples

rcllr ingest --scope work --input - <<'EOF'
{"changes":[{"path":"notes/topic.md","expected":"9f4a55b37576",
  "append":"## New\n- Fact","metadata":{"key_fact":"Proven statement"}}]}
EOF

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

--input PATH

JSON write package; - 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.