@sift-wiki/cli 0.1.4 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +21 -0
  2. package/dist/bin/sift.js +878 -304
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -47,5 +47,26 @@ sift ask "what changed this week?"
47
47
  The CLI is a hosted thin client. `sift login` is the normal setup path and opens
48
48
  the existing browser login flow.
49
49
 
50
+ ## Roam Research import
51
+
52
+ Open the graph in Roam Desktop, then approve read-only local access:
53
+
54
+ ```bash
55
+ npx -y @roam-research/roam-mcp connect --access-level read-only
56
+ ```
57
+
58
+ Import only pages marked `[[Sift]]` in Roam:
59
+
60
+ ```bash
61
+ sift roam import --scope sift-tag
62
+ ```
63
+
64
+ Import the whole graph only when you intentionally want Sift to read every
65
+ readable page:
66
+
67
+ ```bash
68
+ sift roam import --scope whole-graph --confirm-whole-graph
69
+ ```
70
+
50
71
  For repo-local install details, troubleshooting, and advanced CI/headless
51
72
  env-token auth, see `docs/cli/install.md`.