Garry's Opinionated OpenClaw/Hermes Agent Brain
TypeScript
{
"golden": [
{
"argv": "",
"exitCode": 0,
"stderr": [],
"stdout": [
"gbrain <version> -- personal knowledge brain",
"",
"USAGE",
" gbrain <command> [options]",
"",
"SETUP",
" mcp grant <name> --help Grant hosted access; private credential handoff",
" mcp verify --help Verify connection, permissions, and memory",
" setup claude-code|codex [--dry-run]",
" Give an agent memory: brain + MCP + hooks, verified (--remove undoes)",
" init [--pglite|--supabase|--url] Create brain (PGLite default, no server)",
" init --prefer-postgres [--allow-docker]",
" Postgres-first install ladder (env URL >",
" Supabase token > local PG > docker > PGLite)",
" engine status [--json] [--probe] Which engine + URL source, engine-free",
" db-repair [--yes] [--json] Diagnose/fix Postgres access, engine-free",
" (--yes --apply-rewrites for config rewrites)",
" migrate --to <postgres|pglite> Move the brain between engines (PGLite -> Postgres graduates: plan, then --yes --expect)",
" migrate embeddings --to <p:model> Re-embed onto another embedding provider",
" embeddings enable --embedding-model <p:model> Turn on embeddings in place (keeps pages/facts)",
" embeddings prewarm [--dry-run] Load the vector indexes into shared_buffers when they fit (Postgres)",
" upgrade Self-update",
" check-update [--json] Check for new versions",
" repair [<kind>] [--apply] Preview/apply residual repairs (timeline, visibility, safe-chunks)",
" projections drain [--limit n] Rebuild queued text projections now [--json]",
" doctor [--json] [--fast] [--probe-pglite] Health check (resolver, skills, pgvector, RLS, embeddings; --probe-pglite runs the scratch-store probe)",
" integrations [subcommand] Manage integration recipes (senses + reflexes)",
"",
"MEMORY (facts agents recall; MEMORY_VERBS v1)",
" remember \"<fact>\" --entity <slug> Save a fact the user stated, with --provenance; world-visible",
" facts are pushed into new agent sessions (private: recall only)",
" recall [<entity>] [--query <q>] Find saved facts",
" forget <fact-id> Withdraw a fact",
"",
"PAGES",
" get <slug> Read a page",
" put <slug> [< file.md] Write/update a page",
" delete <slug> Delete a page",
" list [--type T] [--tag T] [--limit N]",
" List pages",
" find <glob|prefix|name> [--type T] [--source S] [--limit N]",
" Find pages by slug, path or title",
"",
"SEARCH",
" search <query> Keyword search (tsvector)",
" query <question> [--expand] Hybrid search (RRF; expansion per search mode)",
" ask <question> [--expand] Alias for query",
"",
"IMPORT/EXPORT",
" import <dir> [--no-embed] Import markdown directory",
" sync [--repo <path>] [flags] Git-to-brain incremental sync",
" sync --watch [--interval N] Continuous sync (loops until stopped)",
" See also: autopilot --install (continuous daemon).",
" sync --all --missing-path skip Classify sources whose local_path is absent",
" on this machine as skipped, not failed",
" export [--source <id>] [--dir <p>] Coherent Markdown snapshot; fresh output, no overwrite",
" export --restore-only [--repo <p>] Restore missing db_only files; export --help for safe retry",
" [--type T] [--slug-prefix S] With optional filters",
"",
"FILES",
" files list [slug] List stored files",
" files upload <file> --page <slug> Upload file to storage",
" files upload-raw <file> --page <s> Smart upload (size routing + .redirect.yaml)",
" files signed-url <path> Generate signed URL (1-hour)",
" files sync <dir> Bulk upload directory",
" files verify Verify all uploads",
"",
"EMBEDDINGS",
" embed [<slug>|--all|--stale] Generate/refresh embeddings",
"",
"LINKS",
" link <from> <to> Create typed link (alias: link-add)",
" [--link-type T] [--link-source S] provenance defaults to 'manual'",
" unlink <from> <to> Remove link (alias: link-rm)",
" [--link-type T] [--link-source S] filter which edges to remove",
" link-sources List provenances in use, with edge counts",
" backlinks <slug> Incoming links",
" graph <slug> [--depth N] Traverse link graph (nodes locally; remote MCP defaults to bidirectional edges)",
" graph-query <slug> [--type T] Edge-based traversal with type/direction filters",
" [--depth N] [--direction in|out|both]",
"",
"TAGS",
" tags <slug> List tags",
" tag <slug> <tag> Add tag",
" untag <slug> <tag> Remove tag",
"",
"TIMELINE",
" timeline [<slug>] View timeline",
" timeline-add <slug> <date> <text> Add timeline entry",
"",
"TOOLS",
" extract <links|timeline|all> Extract links/timeline (idempotent)",
" [--source fs|db] [--source-id ID] [--dir <brain>]",
" [--type T] [--since DATE] [--include-frontmatter]",
" [--workers N|--concurrency N] [--dry-run] [--json]",
" extract links --by-mention [--ner] --source db",
" extract timeline --from-meetings [--infer-dates] --source db",
" extract --stale [--source-id ID] [--catch-up] [--dry-run] [--json]",
" extract links --source db --repair-attendance --source-id ID",
" [--limit 250] [--after-slug SLUG] [--json]",
" Apply: --apply-preview FILE --confirm DIGEST --yes --backup-verified --checkpoint FILE",
" extract --explain <kind> [--json] Full details: gbrain extract --help",
" publish <page.md> [--password] Shareable HTML (strips private data, optional AES-256)",
" check-backlinks <check|fix> [dir] Find/fix missing back-links across brain",
" lint <dir|file> [--fix] Catch LLM artifacts, placeholder dates, bad frontmatter",
" backfill <kind|list> v0.30.1: run a registered backfill (effective-date, ...)",
" orphans [--json] [--count] Find pages with no inbound wikilinks",
" beliefs <enable|status|...> Belief ledger coverage: enable, disable, status, reconcile, backfill",
" salience [--days N] [--kind P] v0.29: pages ranked by emotional + activity salience",
" anomalies [--since D] [--sigma N] v0.29: cohort-based statistical anomalies (tag, type)",
" feedback <status|reset> retrieval feedback: learned page weights; rate answers with gbrain rate",
" transcripts <ingest|status|recent> v0.46: import agent session logs + chat exports (local-only)",
" dream [--dry-run] [--json] Run the overnight maintenance cycle once (cron-friendly).",
" See also: autopilot --install (continuous daemon).",
" compile-context --target <t> Compile a deterministic, scanned, budgeted context",
" [--budget N] [--check] file (claude-code | codex | openclaw)",
" decide <status|probe|enable|...> System One decision support (Jev); every slot off by default",
" memory-proposals list|show|approve|deny QM's proposed timeline entries and links awaiting your decision",
" facts relink [--dry-run] Link facts saved without an entity to the entity they name",
" check-resolvable [--json] [--fix] Validate skill tree (reachability/MECE/DRY)",
" report --type <name> --content ... Save timestamped report to brain/reports/",
" questions pin|list|status|refresh|unpin Pinned questions: cited answers kept current (owner-private)",
"",
"OPEN LOOPS (Gmail/Calendar/Contacts connector — v0.47)",
" google setup [--account <email>] One command: BYO OAuth → source → first sync → first digest",
" google connect|status|disconnect Connect/inspect/remove a Google account (idempotent; --json)",
" waiting [--top N] [--json] Who is waiting on you, what you promised, context to respond",
" loops list|show|done|drop|mute Inspect and manage open loops (mute sender <email>)",
" core list|show|status|add|remove Always-loaded core memory (also diff|ack|init|suggest)",
" creds list|remove|export|import Generic credential vault (redacted output; encrypted bundles)",
"",
"BRAIN (capture / ideate / explore — v0.37/v0.38)",
" capture [content] [--file PATH] Single entrypoint for getting content into the brain (a page;",
" a fact to recall later is `remember`)",
" [--stdin] [--slug s] [--type t] Inline content / file / stdin; writes to inbox/ by default",
" [--source ID] [--quiet|--json] Multi-source brains: route to a non-default source",
" brainstorm <question> [--json] Bisociation idea generator (hybrid search + far-set + judge)",
" [--save|--no-save] [--limit N]",
" lsd <question> [--json] Lateral Synaptic Drift: inverted-judge brainstorm",
" [--save|--no-save] [--limit N] rewarding far-from-obvious + axiomatic inversions",
" think \"<question>\" [--anchor <s>] Multi-hop cited synthesis across pages + takes + graph",
" [--save] [--source <id>] Full flags: gbrain think --help",
"",
"SOURCES (multi-repo / multi-brain)",
" sources list Show registered sources",
" sources add <id> --path <p> Register a source (id = short name, e.g. 'wiki')",
" sources remove <id> Remove a source + its pages (--confirm-destructive)",
" sources archive <id> Soft-delete: hide from search, recoverable for 72h",
" sources restore <id> Un-archive a soft-deleted source",
" sources archived List soft-deleted sources and their purge expiry",
" sources purge [<id>] Permanently delete archived sources",
" sources status Per-source dashboard (sync lag, embed coverage)",
" guests init [--writer <w>] [--yes] Set up a guest source for outside guests' notes",
" sources --help Full subcommand list (rename, default, attach,",
" current, federate, set-cr-mode, webhook, harden, ...)",
" sync --all Sync all sources with a local_path",
" sync --source <id> Sync one specific source",
" git commit-push -m <m> -- <paths> Commit + push only those paths in a shared checkout",
" (lock, in-memory merge, no rebase/stash); --pull, --push-only",
" repos ... DEPRECATED alias for 'sources' (v0.19.0)",
"",
"CODE INDEXING (v0.19.0 / v0.20.0 Cathedral II)",
" code-def <symbol> [--lang l] Find the definition of a symbol across code pages",
" code-refs <symbol> [--lang l] Find all references to a symbol (JSON-first)",
" code-callers <symbol> Who calls this symbol? (v0.20.0 A1)",
" code-callees <symbol> What does this symbol call? (v0.20.0 A1)",
" query <q> --lang <l> Filter hybrid search to one language (v0.20.0)",
" query <q> --symbol-kind <k> Filter to symbol type (function|class|method|...) (v0.20.0)",
" reconcile-links [--source id] [--dry-run] Batch-recompute doc↔impl edges in one source",
" reindex-code [--source id] [--yes] [--force] Explicit code-page reindex (v0.20.0; --force re-chunks unchanged pages)",
" reindex-search-vector [--dry-run] [--yes] [--json]",
" Recreate FTS triggers + backfill under",
" $GBRAIN_FTS_LANGUAGE (default 'english')",
" sync --strategy code Sync code files into the brain",
"",
"JOBS (Minions)",
" jobs submit <name> [--params JSON] Submit background job [--follow] [--dry-run]",
" jobs list [--status S] [--limit N] List jobs [--json]",
" jobs get <id> [--json] Job details + history",
" jobs cancel <id> Cancel job",
" jobs retry <id> Re-queue failed/dead job",
" jobs prune [--older-than 30d] Clean old jobs",
" jobs stats [--json] Job health dashboard",
" jobs watch [--follow] Live queue dashboard",
" jobs work [--queue Q] Start worker daemon (Postgres only)",
" jobs supervisor [start|status|stop] Auto-restarting worker wrapper",
"",
"ADMIN",
" stats Brain statistics",
" stats --by source,type [--since 30d] [--collapse-aliases]",
" Live page counts per source and type",
" health Brain health dashboard",
" history <slug> [--json] Page version history",
" revert <slug> <version-id> Revert to version",
" features [--json] [--auto-fix] Scan usage + recommend unused features",
" autopilot [--repo] [--interval N] Self-maintaining brain daemon",
" config [show|get|set] <key> [val] Brain config",
" pricing [set|list|unset] <model> Register model prices for cost caps (host only)",
" protocol [conformance|stats] MEMORY_VERBS v1: schemas, conformance",
" certification, local usage stats + TTHW",
" storage status [--repo <path>] Storage tier status and health",
" [--json] (git-tracked vs supabase-only)",
" serve MCP server (stdio)",
" --surface verbs|starter|full Tool surface: the 7 memory verbs, the ~20-op",
" starter set, or every op (default full).",
" On --http this is the per-client CEILING.",
" --advertise verbs|starter|full List only this surface in tools/list (plus",
" request_tools); the rest stays callable.",
" --access read-only|full stdio: list and dispatch only read operations",
" serve --http [--port N] HTTP MCP server with OAuth 2.1",
" --token-ttl N Access token TTL in seconds, 60-7776000 (default: 3600)",
" --enable-dcr Enable Dynamic Client Registration (DCR clients default to authorization_code)",
" --enable-dcr-insecure Also allow the consent-bypassing client_credentials grant on DCR (implies --enable-dcr)",
" --public-url URL Public issuer URL (required behind proxy/tunnel)",
" connect <mcp-url> --token <t> Wire Claude Code to a remote gbrain (bearer token)",
" [--install] [--json] Print the paste-ready command, or --install to run it",
" auth <create|list|revoke|...> Manage legacy tokens + OAuth 2.1 clients",
" auth --help Full subcommand list (register-client,",
" rescope, rescope-client, rescope-token, revoke-client, ...)",
" watch [--json] Push-based context: pipe conversation turns in,",
" volunteered brain pages stream out (#2095)",
" call <tool> '<json>' Raw tool invocation",
" version Version info",
" --tools-json Tool discovery (JSON)",
"",
"Run gbrain <command> --help for command-specific help.",
""
]
},
{
"argv": "--help",
"exitCode": 0,
"stderr": [],
"stdout": [
"gbrain <version> -- personal knowledge brain",
"",
"USAGE",
" gbrain <command> [options]",
"",
"SETUP",
" mcp grant <name> --help Grant hosted access; private credential handoff",
" mcp verify --help Verify connection, permissions, and memory",
" setup claude-code|codex [--dry-run]",
" Give an agent memory: brain + MCP + hooks, verified (--remove undoes)",
" init [--pglite|--supabase|--url] Create brain (PGLite default, no server)",
" init --prefer-postgres [--allow-docker]",
" Postgres-first install ladder (env URL >",
" Supabase token > local PG > docker > PGLite)",
" engine status [--json] [--probe] Which engine + URL source, engine-free",
" db-repair [--yes] [--json] Diagnose/fix Postgres access, engine-free",
" (--yes --apply-rewrites for config rewrites)",
" migrate --to <postgres|pglite> Move the brain between engines (PGLite -> Postgres graduates: plan, then --yes --expect)",
" migrate embeddings --to <p:model> Re-embed onto another embedding provider",
" embeddings enable --embedding-model <p:model> Turn on embeddings in place (keeps pages/facts)",
" embeddings prewarm [--dry-run] Load the vector indexes into shared_buffers when they fit (Postgres)",
" upgrade Self-update",
" check-update [--json] Check for new versions",
" repair [<kind>] [--apply] Preview/apply residual repairs (timeline, visibility, safe-chunks)",
" projections drain [--limit n] Rebuild queued text projections now [--json]",
" doctor [--json] [--fast] [--probe-pglite] Health check (resolver, skills, pgvector, RLS, embeddings; --probe-pglite runs the scratch-store probe)",
" integrations [subcommand] Manage integration recipes (senses + reflexes)",
"",
"MEMORY (facts agents recall; MEMORY_VERBS v1)",
" remember \"<fact>\" --entity <slug> Save a fact the user stated, with --provenance; world-visible",
" facts are pushed into new agent sessions (private: recall only)",
" recall [<entity>] [--query <q>] Find saved facts",
" forget <fact-id> Withdraw a fact",
"",
"PAGES",
" get <slug> Read a page",
" put <slug> [< file.md] Write/update a page",
" delete <slug> Delete a page",
" list [--type T] [--tag T] [--limit N]",
" List pages",
" find <glob|prefix|name> [--type T] [--source S] [--limit N]",
" Find pages by slug, path or title",
"",
"SEARCH",
" search <query> Keyword search (tsvector)",
" query <question> [--expand] Hybrid search (RRF; expansion per search mode)",
" ask <question> [--expand] Alias for query",
"",
"IMPORT/EXPORT",
" import <dir> [--no-embed] Import markdown directory",
" sync [--repo <path>] [flags] Git-to-brain incremental sync",
" sync --watch [--interval N] Continuous sync (loops until stopped)",
" See also: autopilot --install (continuous daemon).",
" sync --all --missing-path skip Classify sources whose local_path is absent",
" on this machine as skipped, not failed",
" export [--source <id>] [--dir <p>] Coherent Markdown snapshot; fresh output, no overwrite",
" export --restore-only [--repo <p>] Restore missing db_only files; export --help for safe retry",
" [--type T] [--slug-prefix S] With optional filters",
"",
"FILES",
" files list [slug] List stored files",
" files upload <file> --page <slug> Upload file to storage",
" files upload-raw <file> --page <s> Smart upload (size routing + .redirect.yaml)",
" files signed-url <path> Generate signed URL (1-hour)",
" files sync <dir> Bulk upload directory",
" files verify Verify all uploads",
"",
"EMBEDDINGS",
" embed [<slug>|--all|--stale] Generate/refresh embeddings",
"",
"LINKS",
" link <from> <to> Create typed link (alias: link-add)",
" [--link-type T] [--link-source S] provenance defaults to 'manual'",
" unlink <from> <to> Remove link (alias: link-rm)",
" [--link-type T] [--link-source S] filter which edges to remove",
" link-sources List provenances in use, with edge counts",
" backlinks <slug> Incoming links",
" graph <slug> [--depth N] Traverse link graph (nodes locally; remote MCP defaults to bidirectional edges)",
" graph-query <slug> [--type T] Edge-based traversal with type/direction filters",
" [--depth N] [--direction in|out|both]",
"",
"TAGS",
" tags <slug> List tags",
" tag <slug> <tag> Add tag",
" untag <slug> <tag> Remove tag",
"",
"TIMELINE",
" timeline [<slug>] View timeline",
" timeline-add <slug> <date> <text> Add timeline entry",
"",
"TOOLS",
" extract <links|timeline|all> Extract links/timeline (idempotent)",
" [--source fs|db] [--source-id ID] [--dir <brain>]",
" [--type T] [--since DATE] [--include-frontmatter]",
" [--workers N|--concurrency N] [--dry-run] [--json]",
" extract links --by-mention [--ner] --source db",
" extract timeline --from-meetings [--infer-dates] --source db",
" extract --stale [--source-id ID] [--catch-up] [--dry-run] [--json]",
" extract links --source db --repair-attendance --source-id ID",
" [--limit 250] [--after-slug SLUG] [--json]",
" Apply: --apply-preview FILE --confirm DIGEST --yes --backup-verified --checkpoint FILE",
" extract --explain <kind> [--json] Full details: gbrain extract --help",
" publish <page.md> [--password] Shareable HTML (strips private data, optional AES-256)",
" check-backlinks <check|fix> [dir] Find/fix missing back-links across brain",
" lint <dir|file> [--fix] Catch LLM artifacts, placeholder dates, bad frontmatter",
" backfill <kind|list> v0.30.1: run a registered backfill (effective-date, ...)",
" orphans [--json] [--count] Find pages with no inbound wikilinks",
" beliefs <enable|status|...> Belief ledger coverage: enable, disable, status, reconcile, backfill",
" salience [--days N] [--kind P] v0.29: pages ranked by emotional + activity salience",
" anomalies [--since D] [--sigma N] v0.29: cohort-based statistical anomalies (tag, type)",
" feedback <status|reset> retrieval feedback: learned page weights; rate answers with gbrain rate",
" transcripts <ingest|status|recent> v0.46: import agent session logs + chat exports (local-only)",
" dream [--dry-run] [--json] Run the overnight maintenance cycle once (cron-friendly).",
" See also: autopilot --install (continuous daemon).",
" compile-context --target <t> Compile a deterministic, scanned, budgeted context",
" [--budget N] [--check] file (claude-code | codex | openclaw)",
" decide <status|probe|enable|...> System One decision support (Jev); every slot off by default",
" memory-proposals list|show|approve|deny QM's proposed timeline entries and links awaiting your decision",
" facts relink [--dry-run] Link facts saved without an entity to the entity they name",
" check-resolvable [--json] [--fix] Validate skill tree (reachability/MECE/DRY)",
" report --type <name> --content ... Save timestamped report to brain/reports/",
" questions pin|list|status|refresh|unpin Pinned questions: cited answers kept current (owner-private)",
"",
"OPEN LOOPS (Gmail/Calendar/Contacts connector — v0.47)",
" google setup [--account <email>] One command: BYO OAuth → source → first sync → first digest",
" google connect|status|disconnect Connect/inspect/remove a Google account (idempotent; --json)",
" waiting [--top N] [--json] Who is waiting on you, what you promised, context to respond",
" loops list|show|done|drop|mute Inspect and manage open loops (mute sender <email>)",
" core list|show|status|add|remove Always-loaded core memory (also diff|ack|init|suggest)",
" creds list|remove|export|import Generic credential vault (redacted output; encrypted bundles)",
"",
"BRAIN (capture / ideate / explore — v0.37/v0.38)",
" capture [content] [--file PATH] Single entrypoint for getting content into the brain (a page;",
" a fact to recall later is `remember`)",
" [--stdin] [--slug s] [--type t] Inline content / file / stdin; writes to inbox/ by default",
" [--source ID] [--quiet|--json] Multi-source brains: route to a non-default source",
" brainstorm <question> [--json] Bisociation idea generator (hybrid search + far-set + judge)",
" [--save|--no-save] [--limit N]",
" lsd <question> [--json] Lateral Synaptic Drift: inverted-judge brainstorm",
" [--save|--no-save] [--limit N] rewarding far-from-obvious + axiomatic inversions",
" think \"<question>\" [--anchor <s>] Multi-hop cited synthesis across pages + takes + graph",
" [--save] [--source <id>] Full flags: gbrain think --help",
"",
"SOURCES (multi-repo / multi-brain)",
" sources list Show registered sources",
" sources add <id> --path <p> Register a source (id = short name, e.g. 'wiki')",
" sources remove <id> Remove a source + its pages (--confirm-destructive)",
" sources archive <id> Soft-delete: hide from search, recoverable for 72h",
" sources restore <id> Un-archive a soft-deleted source",
" sources archived List soft-deleted sources and their purge expiry",
" sources purge [<id>] Permanently delete archived sources",
" sources status Per-source dashboard (sync lag, embed coverage)",
" guests init [--writer <w>] [--yes] Set up a guest source for outside guests' notes",
" sources --help Full subcommand list (rename, default, attach,",
" current, federate, set-cr-mode, webhook, harden, ...)",
" sync --all Sync all sources with a local_path",
" sync --source <id> Sync one specific source",
" git commit-push -m <m> -- <paths> Commit + push only those paths in a shared checkout",
" (lock, in-memory merge, no rebase/stash); --pull, --push-only",
" repos ... DEPRECATED alias for 'sources' (v0.19.0)",
"",
"CODE INDEXING (v0.19.0 / v0.20.0 Cathedral II)",
" code-def <symbol> [--lang l] Find the definition of a symbol across code pages",
" code-refs <symbol> [--lang l] Find all references to a symbol (JSON-first)",
" code-callers <symbol> Who calls this symbol? (v0.20.0 A1)",
" code-callees <symbol> What does this symbol call? (v0.20.0 A1)",
" query <q> --lang <l> Filter hybrid search to one language (v0.20.0)",
" query <q> --symbol-kind <k> Filter to symbol type (function|class|method|...) (v0.20.0)",
" reconcile-links [--source id] [--dry-run] Batch-recompute doc↔impl edges in one source",
" reindex-code [--source id] [--yes] [--force] Explicit code-page reindex (v0.20.0; --force re-chunks unchanged pages)",
" reindex-search-vector [--dry-run] [--yes] [--json]",
" Recreate FTS triggers + backfill under",
" $GBRAIN_FTS_LANGUAGE (default 'english')",
" sync --strategy code Sync code files into the brain",
"",
"JOBS (Minions)",
" jobs submit <name> [--params JSON] Submit background job [--follow] [--dry-run]",
" jobs list [--status S] [--limit N] List jobs [--json]",
" jobs get <id> [--json] Job details + history",
" jobs cancel <id> Cancel job",
" jobs retry <id> Re-queue failed/dead job",
" jobs prune [--older-than 30d] Clean old jobs",
" jobs stats [--json] Job health dashboard",
" jobs watch [--follow] Live queue dashboard",
" jobs work [--queue Q] Start worker daemon (Postgres only)",
" jobs supervisor [start|status|stop] Auto-restarting worker wrapper",
"",
"ADMIN",
" stats Brain statistics",
" stats --by source,type [--since 30d] [--collapse-aliases]",
" Live page counts per source and type",
" health Brain health dashboard",
" history <slug> [--json] Page version history",
" revert <slug> <version-id> Revert to version",
" features [--json] [--auto-fix] Scan usage + recommend unused features",
" autopilot [--repo] [--interval N] Self-maintaining brain daemon",
" config [show|get|set] <key> [val] Brain config",
" pricing [set|list|unset] <model> Register model prices for cost caps (host only)",
" protocol [conformance|stats] MEMORY_VERBS v1: schemas, conformance",
" certification, local usage stats + TTHW",
" storage status [--repo <path>] Storage tier status and health",
" [--json] (git-tracked vs supabase-only)",
" serve MCP server (stdio)",
" --surface verbs|starter|full Tool surface: the 7 memory verbs, the ~20-op",
" starter set, or every op (default full).",
" On --http this is the per-client CEILING.",
" --advertise verbs|starter|full List only this surface in tools/list (plus",
" request_tools); the rest stays callable.",
" --access read-only|full stdio: list and dispatch only read operations",
" serve --http [--port N] HTTP MCP server with OAuth 2.1",
" --token-ttl N Access token TTL in seconds, 60-7776000 (default: 3600)",
" --enable-dcr Enable Dynamic Client Registration (DCR clients default to authorization_code)",
" --enable-dcr-insecure Also allow the consent-bypassing client_credentials grant on DCR (implies --enable-dcr)",
" --public-url URL Public issuer URL (required behind proxy/tunnel)",
" connect <mcp-url> --token <t> Wire Claude Code to a remote gbrain (bearer token)",
" [--install] [--json] Print the paste-ready command, or --install to run it",
" auth <create|list|revoke|...> Manage legacy tokens + OAuth 2.1 clients",
" auth --help Full subcommand list (register-client,",
" rescope, rescope-client, rescope-token, revoke-client, ...)",
" watch [--json] Push-based context: pipe conversation turns in,",
" volunteered brain pages stream out (#2095)",
" call <tool> '<json>' Raw tool invocation",
" version Version info",
" --tools-json Tool discovery (JSON)",
"",
"Run gbrain <command> --help for command-specific help.",
""
]
},
{
"argv": "-h",
"exitCode": 0,
"stderr": [],
"stdout": [
"gbrain <version> -- personal knowledge brain",
"",
"USAGE",
" gbrain <command> [options]",
"",
"SETUP",
" mcp grant <name> --help Grant hosted access; private credential handoff",
" mcp verify --help Verify connection, permissions, and memory",
" setup claude-code|codex [--dry-run]",
" Give an agent memory: brain + MCP + hooks, verified (--remove undoes)",
" init [--pglite|--supabase|--url] Create brain (PGLite default, no server)",
" init --prefer-postgres [--allow-docker]",
" Postgres-first install ladder (env URL >",
" Supabase token > local PG > docker > PGLite)",
" engine status [--json] [--probe] Which engine + URL source, engine-free",
" db-repair [--yes] [--json] Diagnose/fix Postgres access, engine-free",
" (--yes --apply-rewrites for config rewrites)",
" migrate --to <postgres|pglite> Move the brain between engines (PGLite -> Postgres graduates: plan, then --yes --expect)",
" migrate embeddings --to <p:model> Re-embed onto another embedding provider",
" embeddings enable --embedding-model <p:model> Turn on embeddings in place (keeps pages/facts)",
" embeddings prewarm [--dry-run] Load the vector indexes into shared_buffers when they fit (Postgres)",
" upgrade Self-update",
" check-update [--json] Check for new versions",
" repair [<kind>] [--apply] Preview/apply residual repairs (timeline, visibility, safe-chunks)",
" projections drain [--limit n] Rebuild queued text projections now [--json]",
" doctor [--json] [--fast] [--probe-pglite] Health check (resolver, skills, pgvector, RLS, embeddings; --probe-pglite runs the scratch-store probe)",
" integrations [subcommand] Manage integration recipes (senses + reflexes)",
"",
"MEMORY (facts agents recall; MEMORY_VERBS v1)",
" remember \"<fact>\" --entity <slug> Save a fact the user stated, with --provenance; world-visible",
" facts are pushed into new agent sessions (private: recall only)",
" recall [<entity>] [--query <q>] Find saved facts",
" forget <fact-id> Withdraw a fact",
"",
"PAGES",
" get <slug> Read a page",
" put <slug> [< file.md] Write/update a page",
" delete <slug> Delete a page",
" list [--type T] [--tag T] [--limit N]",
" List pages",
" find <glob|prefix|name> [--type T] [--source S] [--limit N]",
" Find pages by slug, path or title",
"",
"SEARCH",
" search <query> Keyword search (tsvector)",
" query <question> [--expand] Hybrid search (RRF; expansion per search mode)",
" ask <question> [--expand] Alias for query",
"",
"IMPORT/EXPORT",
" import <dir> [--no-embed] Import markdown directory",
" sync [--repo <path>] [flags] Git-to-brain incremental sync",
" sync --watch [--interval N] Continuous sync (loops until stopped)",
" See also: autopilot --install (continuous daemon).",
" sync --all --missing-path skip Classify sources whose local_path is absent",
" on this machine as skipped, not failed",
" export [--source <id>] [--dir <p>] Coherent Markdown snapshot; fresh output, no overwrite",
" export --restore-only [--repo <p>] Restore missing db_only files; export --help for safe retry",
" [--type T] [--slug-prefix S] With optional filters",
"",
"FILES",
" files list [slug] List stored files",
" files upload <file> --page <slug> Upload file to storage",
" files upload-raw <file> --page <s> Smart upload (size routing + .redirect.yaml)",
" files signed-url <path> Generate signed URL (1-hour)",
" files sync <dir> Bulk upload directory",
" files verify Verify all uploads",
"",
"EMBEDDINGS",
" embed [<slug>|--all|--stale] Generate/refresh embeddings",
"",
"LINKS",
" link <from> <to> Create typed link (alias: link-add)",
" [--link-type T] [--link-source S] provenance defaults to 'manual'",
" unlink <from> <to> Remove link (alias: link-rm)",
" [--link-type T] [--link-source S] filter which edges to remove",
" link-sources List provenances in use, with edge counts",
" backlinks <slug> Incoming links",
" graph <slug> [--depth N] Traverse link graph (nodes locally; remote MCP defaults to bidirectional edges)",
" graph-query <slug> [--type T] Edge-based traversal with type/direction filters",
" [--depth N] [--direction in|out|both]",
"",
"TAGS",
" tags <slug> List tags",
" tag <slug> <tag> Add tag",
" untag <slug> <tag> Remove tag",
"",
"TIMELINE",
" timeline [<slug>] View timeline",
" timeline-add <slug> <date> <text> Add timeline entry",
"",
"TOOLS",
" extract <links|timeline|all> Extract links/timeline (idempotent)",
" [--source fs|db] [--source-id ID] [--dir <brain>]",
" [--type T] [--since DATE] [--include-frontmatter]",
" [--workers N|--concurrency N] [--dry-run] [--json]",
" extract links --by-mention [--ner] --source db",
" extract timeline --from-meetings [--infer-dates] --source db",
" extract --stale [--source-id ID] [--catch-up] [--dry-run] [--json]",
" extract links --source db --repair-attendance --source-id ID",
" [--limit 250] [--after-slug SLUG] [--json]",
" Apply: --apply-preview FILE --confirm DIGEST --yes --backup-verified --checkpoint FILE",
" extract --explain <kind> [--json] Full details: gbrain extract --help",
" publish <page.md> [--password] Shareable HTML (strips private data, optional AES-256)",
" check-backlinks <check|fix> [dir] Find/fix missing back-links across brain",
" lint <dir|file> [--fix] Catch LLM artifacts, placeholder dates, bad frontmatter",
" backfill <kind|list> v0.30.1: run a registered backfill (effective-date, ...)",
" orphans [--json] [--count] Find pages with no inbound wikilinks",
" beliefs <enable|status|...> Belief ledger coverage: enable, disable, status, reconcile, backfill",
" salience [--days N] [--kind P] v0.29: pages ranked by emotional + activity salience",
" anomalies [--since D] [--sigma N] v0.29: cohort-based statistical anomalies (tag, type)",
" feedback <status|reset> retrieval feedback: learned page weights; rate answers with gbrain rate",
" transcripts <ingest|status|recent> v0.46: import agent session logs + chat exports (local-only)",
" dream [--dry-run] [--json] Run the overnight maintenance cycle once (cron-friendly).",
" See also: autopilot --install (continuous daemon).",
" compile-context --target <t> Compile a deterministic, scanned, budgeted context",
" [--budget N] [--check] file (claude-code | codex | openclaw)",
" decide <status|probe|enable|...> System One decision support (Jev); every slot off by default",
" memory-proposals list|show|approve|deny QM's proposed timeline entries and links awaiting your decision",
" facts relink [--dry-run] Link facts saved without an entity to the entity they name",
" check-resolvable [--json] [--fix] Validate skill tree (reachability/MECE/DRY)",
" report --type <name> --content ... Save timestamped report to brain/reports/",
" questions pin|list|status|refresh|unpin Pinned questions: cited answers kept current (owner-private)",
"",
"OPEN LOOPS (Gmail/Calendar/Contacts connector — v0.47)",
" google setup [--account <email>] One command: BYO OAuth → source → first sync → first digest",
" google connect|status|disconnect Connect/inspect/remove a Google account (idempotent; --json)",
" waiting [--top N] [--json] Who is waiting on you, what you promised, context to respond",
" loops list|show|done|drop|mute Inspect and manage open loops (mute sender <email>)",
" core list|show|status|add|remove Always-loaded core memory (also diff|ack|init|suggest)",
" creds list|remove|export|import Generic credential vault (redacted output; encrypted bundles)",
"",
"BRAIN (capture / ideate / explore — v0.37/v0.38)",
" capture [content] [--file PATH] Single entrypoint for getting content into the brain (a page;",
" a fact to recall later is `remember`)",
" [--stdin] [--slug s] [--type t] Inline content / file / stdin; writes to inbox/ by default",
" [--source ID] [--quiet|--json] Multi-source brains: route to a non-default source",
" brainstorm <question> [--json] Bisociation idea generator (hybrid search + far-set + judge)",
" [--save|--no-save] [--limit N]",
" lsd <question> [--json] Lateral Synaptic Drift: inverted-judge brainstorm",
" [--save|--no-save] [--limit N] rewarding far-from-obvious + axiomatic inversions",
" think \"<question>\" [--anchor <s>] Multi-hop cited synthesis across pages + takes + graph",
" [--save] [--source <id>] Full flags: gbrain think --help",
"",
"SOURCES (multi-repo / multi-brain)",
" sources list Show registered sources",
" sources add <id> --path <p> Register a source (id = short name, e.g. 'wiki')",
" sources remove <id> Remove a source + its pages (--confirm-destructive)",
" sources archive <id> Soft-delete: hide from search, recoverable for 72h",
" sources restore <id> Un-archive a soft-deleted source",
" sources archived List soft-deleted sources and their purge expiry",
" sources purge [<id>] Permanently delete archived sources",
" sources status Per-source dashboard (sync lag, embed coverage)",
" guests init [--writer <w>] [--yes] Set up a guest source for outside guests' notes",
" sources --help Full subcommand list (rename, default, attach,",
" current, federate, set-cr-mode, webhook, harden, ...)",
" sync --all Sync all sources with a local_path",
" sync --source <id> Sync one specific source",
" git commit-push -m <m> -- <paths> Commit + push only those paths in a shared checkout",
" (lock, in-memory merge, no rebase/stash); --pull, --push-only",
" repos ... DEPRECATED alias for 'sources' (v0.19.0)",
"",
"CODE INDEXING (v0.19.0 / v0.20.0 Cathedral II)",
" code-def <symbol> [--lang l] Find the definition of a symbol across code pages",
" code-refs <symbol> [--lang l] Find all references to a symbol (JSON-first)",
" code-callers <symbol> Who calls this symbol? (v0.20.0 A1)",
" code-callees <symbol> What does this symbol call? (v0.20.0 A1)",
" query <q> --lang <l> Filter hybrid search to one language (v0.20.0)",
" query <q> --symbol-kind <k> Filter to symbol type (function|class|method|...) (v0.20.0)",
" reconcile-links [--source id] [--dry-run] Batch-recompute doc↔impl edges in one source",
" reindex-code [--source id] [--yes] [--force] Explicit code-page reindex (v0.20.0; --force re-chunks unchanged pages)",
" reindex-search-vector [--dry-run] [--yes] [--json]",
" Recreate FTS triggers + backfill under",
" $GBRAIN_FTS_LANGUAGE (default 'english')",
" sync --strategy code Sync code files into the brain",
"",
"JOBS (Minions)",
" jobs submit <name> [--params JSON] Submit background job [--follow] [--dry-run]",
" jobs list [--status S] [--limit N] List jobs [--json]",
" jobs get <id> [--json] Job details + history",
" jobs cancel <id> Cancel job",
" jobs retry <id> Re-queue failed/dead job",
" jobs prune [--older-than 30d] Clean old jobs",
" jobs stats [--json] Job health dashboard",
" jobs watch [--follow] Live queue dashboard",
" jobs work [--queue Q] Start worker daemon (Postgres only)",
" jobs supervisor [start|status|stop] Auto-restarting worker wrapper",
"",
"ADMIN",
" stats Brain statistics",
" stats --by source,type [--since 30d] [--collapse-aliases]",
" Live page counts per source and type",
" health Brain health dashboard",
" history <slug> [--json] Page version history",
" revert <slug> <version-id> Revert to version",
" features [--json] [--auto-fix] Scan usage + recommend unused features",
" autopilot [--repo] [--interval N] Self-maintaining brain daemon",
" config [show|get|set] <key> [val] Brain config",
" pricing [set|list|unset] <model> Register model prices for cost caps (host only)",
" protocol [conformance|stats] MEMORY_VERBS v1: schemas, conformance",
" certification, local usage stats + TTHW",
" storage status [--repo <path>] Storage tier status and health",
" [--json] (git-tracked vs supabase-only)",
" serve MCP server (stdio)",
" --surface verbs|starter|full Tool surface: the 7 memory verbs, the ~20-op",
" starter set, or every op (default full).",
" On --http this is the per-client CEILING.",
" --advertise verbs|starter|full List only this surface in tools/list (plus",
" request_tools); the rest stays callable.",
" --access read-only|full stdio: list and dispatch only read operations",
" serve --http [--port N] HTTP MCP server with OAuth 2.1",
" --token-ttl N Access token TTL in seconds, 60-7776000 (default: 3600)",
" --enable-dcr Enable Dynamic Client Registration (DCR clients default to authorization_code)",
" --enable-dcr-insecure Also allow the consent-bypassing client_credentials grant on DCR (implies --enable-dcr)",
" --public-url URL Public issuer URL (required behind proxy/tunnel)",
" connect <mcp-url> --token <t> Wire Claude Code to a remote gbrain (bearer token)",
" [--install] [--json] Print the paste-ready command, or --install to run it",
" auth <create|list|revoke|...> Manage legacy tokens + OAuth 2.1 clients",
" auth --help Full subcommand list (register-client,",
" rescope, rescope-client, rescope-token, revoke-client, ...)",
" watch [--json] Push-based context: pipe conversation turns in,",
" volunteered brain pages stream out (#2095)",
" call <tool> '<json>' Raw tool invocation",
" version Version info",
" --tools-json Tool discovery (JSON)",
"",
"Run gbrain <command> --help for command-specific help.",
""
]
},
{
"argv": "--version",
"exitCode": 0,
"stderr": [],
"stdout": [
"gbrain <version>"
]
},
{
"argv": "version",
"exitCode": 0,
"stderr": [],
"stdout": [
"gbrain <version>"
]
},
{
"argv": "definitely-not-a-command",
"exitCode": 2,
"stderr": [
"Error [unknown_command]: Unknown command: definitely-not-a-command",
"Fix: Run `gbrain --help` for available commands.",
"Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#unknown_command"
],
"stdout": []
},
{
"argv": "definitely-not-a-command --help",
"exitCode": 2,
"stderr": [
"Error [unknown_command]: Unknown command: definitely-not-a-command",
"Fix: Run `gbrain --help` for available commands.",
"Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#unknown_command"
],
"stdout": []
},
{
"argv": "ask --help",
"exitCode": 0,
"stderr": [],
"stdout": [
"Usage: gbrain query <query> [options]",
"",
"Hybrid search for concept/landscape questions and people/companies/projects by topic; adds fact rows. expand: one LLM call (expansion recovers synonyms; rarely helps). Still top-K; return_unit: sections or conversations. Lists: list_pages. Exact tokens: `search` is cheaper. Personal: get_recent_salience, find_anomalies; transcripts: `gbrain transcripts recent`. Do NOT assume 'crazy' means impressive (often difficult or emotionally charged). Needs an embedding key (else keyword-only); expansion needs a chat key. Fact rows: use follow_up. fields: \"full\" adds diagnostics.",
"",
"Options:",
" <query> Question or topic (required unless image).",
" --image Base64 image.",
" --image-mime MIME type of image.",
" --limit Default 10/25/50 by search mode.",
" --offset Rows to skip.",
" --types Page types, e.g. ['person'].",
" --where Frontmatter equality, e.g. {status: \"active\"}; a list matches any.",
" --snippet-chars Chars per row (0 = full).",
" --return-unit Default auto: whole conversations.",
" --return-window Window radius 1-3.",
" --token-budget Evidence token cap.",
" --expand Default off; one LLM call, rarely helps.",
" --detail low (compiled truth), medium (default) or high (all chunks).",
" --fields lean (remote default) or full.",
" --mode Local callers only.",
" --lang Code language.",
" --symbol-kind Code symbol type.",
" --near-symbol Anchor code symbol.",
" --walk-depth Code walk depth 1-2.",
" --salience Boost emotional pages.",
" --recency Boost recent pages.",
" --since On/after: YYYY-MM-DD or 7d/2w/1y.",
" --until On/before.",
" --source-id One source, or '__all__'.",
" --source-ids Narrow to these sources (omit or [] for all you can read).",
" --cross-modal Default auto.",
" --embedding-column Registered embedding column.",
" --adaptive-return true for one answer (fewer rows, never empty); omit for breadth.",
" --autocut Default on (never empty); false: full top-K for breadth.",
" --relational Relationship-graph arm (default on).",
" --min-trust Lowest trust tier to return (the connection floor still applies).",
" --explain Per-row score_details.",
" --explain-target Expected page (slug or source:slug): why it is missing.",
"",
"Examples:",
" gbrain query \"what changed at acme-example\" --types meeting --since 2026-01-01 --until 2026-03-31",
" gbrain query \"open deals\" --where stage=seed,series-a --json --timings"
]
},
{
"argv": "link-add --help",
"exitCode": 0,
"stderr": [],
"stdout": [
"Usage: gbrain link-add <from> <to> [options]",
"",
"Create a typed link (edge) from one page to another in the same source. Use when recording a relationship (works_at, invested_in, mentions); remote page writes already link [[wikilinks]] to existing pages as mentions (receipt auto_links), so add only typed links or ones the text lacks. Needs write scope; an explicit link_type must be declared by the active schema pack. On page_not_found: resolve both slugs with resolve_slugs.",
"",
"Options:",
" --request-id Reuse only to retry.",
" <from> Slug of the page the link originates from (the edge renders on this page), e.g. 'people/alice-example'. These are page slugs — there is no `source`/`target` pair. (required)",
" <to> Slug of the page the link points to, e.g. 'companies/acme-example'. (required)",
" --link-type Link type (e.g., invested_in, works_at). When the active schema pack declares a link vocabulary, an explicit link_type must be one of its declared verbs (undeclared verbs are rejected, also under dry_run). Omitted = untyped edge.",
" --context Context for the link",
" --link-source Provenance tag (kebab-case, e.g. 'citation-graph'). Defaults to 'manual'. Reconciliation-managed built-ins (markdown/frontmatter/mentions/wikilink-resolved) are rejected.",
" --valid-from When the relationship started (YYYY-MM-DD), for dated relations such as works_at or invested_in.",
" --valid-until When it ended (YYYY-MM-DD, exclusive). Re-run add_link with valid_until to record that a relationship ended."
]
},
{
"argv": "lint --help",
"exitCode": 0,
"stderr": [],
"stdout": [
"Usage: gbrain lint",
"",
"gbrain lint - run gbrain --help for the full command list."
]
},
{
"argv": "lint --definitely-not-a-flag",
"exitCode": 2,
"stderr": [
"Error [unknown_flag]: unknown flag --definitely-not-a-flag for 'gbrain lint'",
"Fix: gbrain lint --help",
"Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#unknown_flag"
],
"stdout": []
},
{
"argv": "get",
"exitCode": 2,
"stderr": [
"Error [invalid_params]: Missing required parameter 'slug' for 'gbrain get'.",
"Fix: Usage: gbrain get <slug> (see `gbrain get --help`).",
"Docs: https://github.com/garrytan/gbrain/blob/master/docs/guides/error-codes.md#invalid_params"
],
"stdout": []
}
],
"normalizer": "cli-help-v1"
}