capture
Installation
SKILL.md
capture — the single ingestion entrypoint
When the user wants to save a thought, an article snippet, a transcript
fragment, or any text into their brain, run gbrain capture. Don't reach
for gbrain put or commit-then-sync — capture is the front door and it
handles both local and thin-client installs the same way.
Contract
- Input: the content to save (inline arg,
--file PATH, or--stdin). - Output: a page in the brain DB AND a markdown file on disk under
<sync.repo_path>/<slug>.md. Receipt printed to stdout. - Side effect: the page becomes immediately queryable via
gbrain query,gbrain search, or any MCP-bound agent. - Idempotency: same content → same
inbox/YYYY-MM-DD-<hash8>slug. The daemon's 24h content-hash dedup catches re-captures. - Trust: all captures via this skill are local-CLI trust (
remote: false). Untrusted webhook ingestion goes throughPOST /ingest, not this verb.