Installation

Installation

Four install paths cover Claude Code, Claude Cowork (admin plugin upload + per-user skills upload), and any other agent platform.

Path 1 — Claude Code (full plugin)

Option A: git clone into the plugins directory:

git clone https://github.com/mrdulasolutions/BOX.git ~/.claude/plugins/box-memory

Option B: download and unzip into a named subdirectory:

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

After install, all 12 skills and /box-* slash commands are available.

Path 2 — Claude Cowork plugin (admin, recommended for orgs)

Cowork accepts the same plugin zip as Claude Code. One install, all 12 skills + commands available org-wide.

1. Download box-memory-plugin.zip from the latest release.
2. Cowork (as admin) → settings → Plugins → Add plugin.
3. Drag the zip in.
4. Every user in the org gets the plugin.

Path 3 — Claude Cowork personal skills (any user)

If you don't have admin rights, or you only want a subset of the skills, upload individual skill zips:

1. Download the per-skill zips from the latest release. Filenames: box-init.zip, box-status.zip, box-tier-detect.zip, box-mcp-check.zip, box-write.zip, box-recall.zip, box-ai-recall.zip, box-companion.zip, box-ai-extract.zip, box-team.zip, box-ai-agent.zip, box-index-rebuild.zip.
2. Cowork → Settings → Skills → Upload skill.
3. Drop each zip you want.

Recommended upload order for the minimum useful set: box-mcp-check → box-init → box-tier-detect → box-write → box-recall. Add the rest as you need them.

Slash commands aren't available via personal skills uploads — only the auto-fire-from-description behavior. The full plugin (Path 1 or 2) is required for slash commands.

Path 4 — Any other agent

Each skill directory is self-contained: SKILL.md + references/ (in the bundled skill zips). Any agent that can read SKILL.md and follow its instructions can use these.

git clone https://github.com/mrdulasolutions/BOX.git
# Point your agent at the skill directories:
ls skills/

For framework-level integration (LangChain / LlamaIndex), see Framework Integrations.

Verify the install

/box-mcp-check

Confirms the Box MCP connection is correct (mcp.box.com), required OAuth scopes are granted, and all expected tools are exposed. See Box MCP Setup for the full setup walkthrough.

SHA256 verification (optional but recommended)

Each release's notes publish SHA256 hashes for every artifact. Verify before install:

shasum -a 256 /tmp/box-memory-plugin.zip
# compare to the value in the release notes

Compatibility

• Workspaces created by an earlier version of this plugin work unchanged.
• v0.1.0 added new skills + workspace config fields (workspace_type, hub, settings.ai_*) — all backward-compatible.
• Reinstalling the latest plugin zip doesn't touch your workspace data; only the skill files in your plugins directory.