Summary

Epic: shuttle chrome — browser integrations with local files as source of truth.

Shell bookmark automation shipped in #1 (closed). This epic tracks CLI polish, tests, docs, and future Chrome features beyond bookmarks.

CLI convention (local-centric)

Same rule as shuttle drive (ingest / upload / sync) and shuttle notion (ingest / deploy / sync).

Hidden legacy: import / export on bookmarks; shuttle bookmarks … (top-level).

Configuration

chrome:
  profile: Default
  bookmarks_file: ~/…/data/bookmarks/bookmarks.html
  downloads_dir: ~/Downloads

Current scaffold

• shuttle/commands/chrome.py — Typer sub-app + script wrappers
• scripts/chrome/ — ingest.sh, deploy.sh, export-bookmarks.sh, import-bookmarks.sh, wait-download.sh
• docs/bookmarks.md, README Chrome section
• Integration smoke with SHUTTLE_SKIP_CHROME_AUTOMATION=1

Child issues

• 02a - Align chrome bookmarks CLI (ingest/deploy) #25 — Align bookmarks CLI to ingest / deploy
• 02.1 — Chrome bookmarks integration tests #26 — Chrome bookmarks integration tests
• 02.2 — Chrome automation workflow docs #27 — Automation workflow docs (Accessibility, launchd)
• 02.3 — Timestamped bookmark snapshots and multi-profile #28 — Timestamped snapshots and multi-profile support
• 02.4 — Bookmarks update script #48 — Bookmarks update script (02e)
• 02.5 — Bookmarks filepath configuration #49 — Bookmarks filepath configuration (02f)
• 02.6 — Google Photos album retrieval #50 — Google Photos album retrieval (02g)

Non-goals (v1)

Chromium/Brave/Arc adapters, bookmark diff UI, bidirectional sync.

Definition of done (epic)

• CLI verbs match local-centric convention with legacy aliases
• Integration tests cover CLI + fixture HTML paths
• Documented macOS permissions and daily workflow
• Roadmap for profiles / dated backups captured in 02.3 — Timestamped bookmark snapshots and multi-profile #28

Execution

Close children as they land; link PRs to this epic.