Skip to content

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 …`
Tested rolling snapshot bob-cli 41afa14 bob-mac-capture 556bb67 bob-plugins af1e691 Built 2026-10-24T22:34:13Z (zensical) build.json