box-cloud-filesystem

# Box Cloud Filesystem Two modes, one goal: treat Box like a local filesystem. **Transparent mode** — initialize a workspace, then every Write or Edit inside it auto-syncs to Box via PostToolUse hooks. No `box` commands needed. **Explicit mode** — search, download, share, or organize files using Box CLI commands directly. See `references/operations-guide.md` for the full command reference. ## Contents - [Overview](#overview) - [Prerequisites](#prerequisites) - [Instructions](#instructions) - [Workspace Sync Pattern](#workspace-sync-pattern) - [Output](#output) - [Error Handling](#error-handling) - [Examples](#examples) - [Resources](#resources) ## Overview Box CLI (`@box/cli`) wraps the full Box API as shell commands. This skill adds three layers: - **Hooks (transparent sync)** — PostToolUse hooks on Write/Edit auto-upload changed files to Box. - **Operational judgment** — file identity via numeric IDs, version uploads over duplicates, narrow sharing defaults, manifest-based conflict detection. - **Sync patterns** — pull/work/push workflow with automatic hook-driven uploads and conflict resolution. Key principle: **inspect before acting, report after acting.** Folder ID `0` is always root. ## Prerequisites ```bash npm install --global @box/cli box login box users:get --me # verify auth + enterprise context ``` Auth methods: OAuth (interactive), JWT (automation), CCG (server-to-server), Developer Token (testing, 60 min). `jq` is required for the hook scripts. #...