bob gkeep¶
Drain the Google Keep inbox into Obsidian tasks
bob gkeep --help
Google Keep → Obsidian inbox drain: move every Keep inbox note into gkeep_inbox.md as Obsidian tasks and archive each note in Keep only after its current content is provably in the vault.
Usage: bob gkeep [OPTIONS] [COMMAND]
Commands:
doctor Check the Keep setup: config, token, adapter, Keep, and target note
list Show Keep inbox notes and gkeep_inbox.md tasks side by side (default)
login Exchange a Google sign-in cookie for a stored Keep master token
migrate-markers Remove Google Keep bookkeeping markers from task Markdown (offline)
migrate-tasks Backfill compact Keep links on open tasks (offline)
pull Move Keep inbox notes into gkeep_inbox.md, then archive them in Keep
help Print this message or the help of the given subcommand(s)
Options:
-a, --all
Also show archived Keep notes and done/canceled vault tasks
-b, --bob-dir <DIR>
Bob vault root; defaults to BOB_DIR or ~/bob
-f, --format <FORMAT>
Output format: table or json
[default: table]
[possible values: table, json]
-h, --help
Show help
-s, --source <SOURCE>
Show both inboxes, Keep only, or the vault only
[default: both]
[possible values: both, keep, vault]
Running `bob gkeep` with no command runs `bob gkeep list`.
Examples:
bob gkeep Show both inboxes and what `pull` would do
bob gkeep list -s vault Show only gkeep_inbox.md tasks (no network)
bob gkeep pull -d Preview the exact Markdown a pull would write
bob gkeep pull -n Write and verify tasks, but leave notes in Keep
bob gkeep pull Write, verify, commit, then archive in Keep
bob gkeep pull -i 3f9c2e1 Pull one note by its REF from `bob gkeep list`
bob gkeep doctor Diagnose credentials, adapter, and connectivity
bob gkeep login One-time setup of the Keep master token
Environment:
BOB_DIR Bob vault root; defaults to ~/bob
BOB_CONFIG_FILE gkeep config; defaults to ~/.config/bob/config.yml
BOB_GKEEP_ADAPTER adapter executable replacing `uv run --script …`