Installation

Installation

Prerequisites

• macOS (Windows in v0.0.4)
• Box Drive installed + signed in
• Claude Code or Claude Cowork host
• Disk encryption (FileVault) — strongly recommended for compliance

Path 1 — Claude Code

mkdir -p ~/.claude/plugins/box-memory-onprem
curl -L -o /tmp/plugin.zip \
  https://github.com/mrdulasolutions/BOX-Onprem/releases/latest/download/box-memory-onprem-plugin.zip
unzip -o /tmp/plugin.zip -d ~/.claude/plugins/box-memory-onprem/

Path 2 — Cowork plugin (admin)

1. Download box-memory-onprem-plugin.zip from the latest release
2. Cowork → settings → Plugins → Add plugin
3. Upload the zip
4. Org-wide rollout

Path 3 — Cowork personal skills (per-user)

Upload individual skill zips: box-drive-detect.zip, box-airgap-status.zip, box-init.zip, etc. via Cowork → Settings → Skills → Upload skill.

Recommended order: box-drive-detect → box-airgap-status → box-init → box-write → box-recall → add the rest as needed.

Path 4 — Other agent platforms

Clone the repo: git clone https://github.com/mrdulasolutions/BOX-Onprem.git. Point your agent at the skills/<name>/SKILL.md files. Each skill is self-contained — no external fetches at runtime.

Verify

/box-drive-detect
/box-airgap-status

Both should report PASS. box-drive-detect confirms the mount + Box Drive process. box-airgap-status reports the broader trust posture (disk encryption, LLM provider).

SHA256 verification

Each release's notes publish SHA256 hashes for the plugin zip and skills bundle. Verify before install:

shasum -a 256 /tmp/plugin.zip
# Compare to the SHA256 in the release notes

This is the v0.0.5 transition target: GPG-signed artifacts. SHA256 is the interim verification mechanism.

Compatibility

• Workspaces created by an earlier version of either plugin (cloud or on-prem) work unchanged
• The schema is pinned via .schema-pin to a specific cloud-repo commit; bumping the pin is a separate, reviewable change
• Reinstalling the plugin zip doesn't touch your workspace data