Save any thought or content into the brain via one CLI command. The single human-facing entrypoint that replaces "put_page vs commit-then-sync vs autopilot-wait" with one command that just works.
75%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Passed
No findings from the security scan
Fix and improve this skill with Tessl
tessl review fix ./skills/capture/SKILL.mdWhen 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.
--file PATH, or --stdin).<sync.repo_path>/<slug>.md. Receipt printed to stdout.gbrain query,
gbrain search, or any MCP-bound agent.inbox/YYYY-MM-DD-<hash8> slug. The
daemon's 24h content-hash dedup catches re-captures.remote: false).
Untrusted webhook ingestion goes through POST /ingest, not this verb.gbrain capture resolves to a put_page call (local) or a remote MCP call
(thin-client). Either way the page lands in the DB AND on disk in one move
via the v0.38 write-through plumbing. The default slug is
inbox/YYYY-MM-DD-<hash8> so captures cluster in a predictable triage
location.
gbrain capture "the thought I want to remember"
gbrain capture --file ./notes/today.md
echo "from a pipe" | gbrain capture --stdin
gbrain capture "..." --slug daily/2026-05-21
gbrain capture "..." --type idea --source voice-whisper
gbrain capture "..." --quiet # script-friendly: prints just the slug
gbrain capture "..." --json # structured output for agentsinbox/YYYY-MM-DD-<hash8> (stable for same content; the daemon's 24h dedup catches re-captures).note (override with --type idea etc.).captured_via: capture-cli, captured_at: <ISO>.…).Default prints a 5-line receipt:
captured:
slug: inbox/2026-05-21-abcdef12
status: created_or_updated
content_hash: f3a7b9c0d1e2f3a4…
file: /Users/you/brain/inbox/2026-05-21-abcdef12.md
captured_at: 2026-05-21T04:15:00.000Z--quiet prints only the slug (use for SLUG=$(gbrain capture "..." --quiet)).
--json prints structured output for downstream tools.
Follow the agent operator protocol for any gbrain error code, exit code, [AGENT] block or notice block. Specific to this skill:
write_pending): the thought was accepted and may still commit. Tell the user it is saved and pending, and poll gbrain write-request <request_id>; never capture it a second time.source_binding_required or insufficient_scope over MCP: this connection cannot write the target source; tell the user which source needs a grant from the brain host's operator.gbrain put. That's the old per-page primitive that
doesn't know about default slug generation, content-type heuristics, or
the receipt block. capture is the human-facing wrapper.gbrain capture.
That's what gbrain sync (or gbrain import) is for. Capture is for
single thoughts, single notes, single transcripts.# Title\n\n<your prose>.
Pass --file PATH if you already have a fully-formatted markdown file.--file or --stdin instead.skills/media-ingest/SKILL.md or gbrain sync insteadskills/idea-ingest/SKILL.md (it knows to build the people page)skills/meeting-ingestion/SKILL.md (attendee enrichment)This skill is for the simple "I have a thought, save it" case. Specialized ingestion paths handle their own slugging + cross-referencing.
garrytan/gbrain
f4d1866
Also appears in
since Nov 15, 2026
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.