Transparent cloud filesystem for AI agents using Box CLI (@box/cli). Upload, download, search, share, and sync files to Box cloud storage with operational safety guardrails.
npx claudepluginhub jeremylongshore/claude-code-plugins-plus-skills --plugin box-cloud-filesystemTransparent cloud filesystem for AI agents using the official Box CLI (@box/cli). Upload, download, search, share, and sync files to Box cloud storage with operational safety guardrails. Works with any Box account — personal, business, or enterprise.
Compatible with: Claude Code, Codex, Perplexity Computer, OpenClaw, and any agent platform that supports skills or system prompts.
Box CLI gives agents raw access to cloud storage. Raw access is not the same as useful access. Without guidance, agents guess at folder targets, create duplicates instead of versioning, default to public sharing, and have no sync pattern.
This plugin adds two layers:
ccpi install box-cloud-filesystem
git clone https://github.com/jeremylongshore/box-cloud-filesystem.git
Then symlink or copy into your Claude Code plugins directory, or reference it directly in your agent configuration.
npm install --global @box/cli
box login
box users:get --me # verify auth
jq is required for the hook scripts. Install via your system package manager if not present.
Box offers a free tier for individual users. See box.com for current pricing and storage limits.
| Component | Path | Purpose |
|---|---|---|
| Skill | skills/box-cloud-filesystem/SKILL.md | Comprehensive Box CLI guide with safety guardrails |
| Hooks | hooks/hooks.json | PostToolUse (Write/Edit → Box upload) + Stop (sync summary) |
| Init script | scripts/box-init-workspace.sh | Pull Box folder locally + build manifest |
| Sync script | scripts/box-sync-on-write.sh | Hook handler: upload changed files to Box |
| Summary script | scripts/box-sync-summary.sh | Stop hook: report what was synced |
Transparent mode — initialize a workspace, then work normally:
# Pull a Box folder locally (FOLDER_ID from Box web UI or `box folders:items 0`)
./scripts/box-init-workspace.sh 123456789 /tmp/box-workspace
# Now just edit files — hooks auto-sync to Box
# When Claude stops responding, the Stop hook prints a sync summary
Explicit mode — use Box CLI directly with the skill's guidance:
box search "quarterly report" --json # Find files
box files:download FILE_ID --destination ./ # Download
box files:upload ./report.md --parent-id 123 # Upload new
box files:versions:upload FILE_ID ./report.md # Update existing (preserves history)
box files:share FILE_ID --access collaborators # Share (never defaults to public)
Operations are classified by risk level:
The skill guides agents toward safe defaults: version uploads over re-uploads, collaborators over open sharing, manifest-based conflict detection before sync.
MIT
Sync Claude Code sessions across devices with encrypted cloud storage
Modifies files
Hook triggers on file write and edit operations
Share bugs, ideas, or general feedback.
Google Gemini File Search for managed RAG with 100+ file formats. Use for document Q&A, knowledge bases, or encountering immutability errors, quota issues, polling failures. Supports Gemini 3 Pro/Flash (Gemini 2.5 legacy).
Commands for syncing CLAUDE.md, permissions allowlist, and refreshing context. Hooks for marketplace-to-plugin sync.
Google Workspace CLI (gws) skill — unified command-line access to Gmail, Drive, Sheets, Docs, Calendar, Chat, Admin, and 40+ Google APIs. Includes MCP server setup, authentication workflows, and agent-optimized usage patterns.
Expert agent for file upload handling, AWS S3 integration, image processing with Sharp, video transcoding with FFmpeg, presigned URLs, and chunked uploads
Manage code snippets in ByteStash - multi-file support, share management, auto-categorization for 30+ languages