just-bash-gdrive 0.1.1 → 0.1.2
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.
- package/README.md +17 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -6,6 +6,22 @@ Lets AI agents interact with Google Drive files using standard bash commands (`l
|
|
|
6
6
|
|
|
7
7
|
Inspired by [just-bash-dropbox](https://github.com/manishrc/just-bash-dropbox) — the same pattern, applied to Google Drive.
|
|
8
8
|
|
|
9
|
+
## Why not just use the Drive API or gogcli?
|
|
10
|
+
|
|
11
|
+
Tools like [gogcli](https://github.com/steipete/gogcli) are great when *you* know exactly what you want to do with Drive. You write the specific command, it runs.
|
|
12
|
+
|
|
13
|
+
`just-bash-gdrive` is for when you want to hand an *agent* the ability to figure that out — and do it safely.
|
|
14
|
+
|
|
15
|
+
**Compositional bash logic at runtime.** An LLM can write arbitrary pipelines on the fly — `find / -name "*.md" | xargs grep "keyword" | sort` — without you anticipating every possible query in advance. No new API code per use case.
|
|
16
|
+
|
|
17
|
+
**Drive as a mountable filesystem.** `MountableFs` lets you compose Drive with other filesystems. An agent works across `/drive` (real files) and `/tmp` (scratch space) in the same bash session. The Drive API has no composability story.
|
|
18
|
+
|
|
19
|
+
**Safe exploration mode.** Mount Drive read-only — the agent can `cat`, `grep`, and `find` freely with zero write risk. There's no equivalent in any Drive CLI.
|
|
20
|
+
|
|
21
|
+
**AI SDK tool wrapper.** The `bash-tool` package from just-bash wraps the whole thing as a single LLM tool. One line to give any model bash access to Drive.
|
|
22
|
+
|
|
23
|
+
**The rule of thumb:** use gogcli when you're writing the script. Use just-bash-gdrive when the agent is writing the script.
|
|
24
|
+
|
|
9
25
|
## Install
|
|
10
26
|
|
|
11
27
|
```bash
|
|
@@ -143,7 +159,7 @@ Rate limit handling: automatically retries on HTTP 429 with `Retry-After` backof
|
|
|
143
159
|
- `chmod`, `symlink`, `link`, `readlink`, `utimes` throw `ENOSYS` — Drive has no POSIX permission or symlink concept
|
|
144
160
|
- `getAllPaths()` returns `[]` until `prefetchAllPaths()` is called — glob operations require prefetch
|
|
145
161
|
- `appendFile` reads the existing file, appends, then rewrites — Drive has no atomic append
|
|
146
|
-
- Google Workspace files (Docs, Sheets, Slides) cannot be read as raw content; use `gog
|
|
162
|
+
- Google Workspace files (Docs, Sheets, Slides) cannot be read as raw content; use `gog export` (gogcli) or the Drive export API to convert them first
|
|
147
163
|
|
|
148
164
|
## Inspiration
|
|
149
165
|
|