box init

box-init

Bootstrap a Box workspace for agent memory + file storage. Tier-aware: Personal uses index files; Business+ adds metadata templates; Enterprise Plus optionally creates a Hub instead of a folder.

Usage

/box-init [workspace-name] [--team=<team>] [--parent=<folder-id>] [--as-hub]

Examples:

• /box-init — folder workspace named box-memory at Box root
• /box-init my-vault --team=engineering — workspace plus an extra team subtree
• /box-init my-vault --as-hub — Box Hub workspace (Enterprise Plus only)

Key behaviors

• Probes tier via box-tier-detect
• Creates folder structure (or a Hub if --as-hub and tier is Enterprise Plus)
• Writes _box-memory.json with capabilities, settings, hub metadata if applicable
• Seeds _index.json in every memory-holding folder
• On Business+, creates the boxMemory metadata template that Box AI Extract targets
• Surfaces the Hub indexing warm-up window if Hub-backed (Operational Notes Note 7)
• Surfaces metadata-template warm-up window (Operational Notes Note 3)

Workspace config defaults

settings:
  default_team: default
  companion_layout: sibling
  ai_recall_enabled: false        # opt-in
  ai_extract_enabled: false       # opt-in
  ai_studio_agent_enabled: false  # opt-in

AI features are off by default — explicit opt-in so users control AI Unit consumption.

When to use

• First-time setup of a Box workspace for agent memory
• Adding a new team subtree to an existing workspace
• Promoting a Personal workspace to Business+ (the skill creates the metadata template on first Business+ run)

When NOT to use

• The workspace already exists and you don't want to re-init — the skill detects and offers use-existing
• --as-hub when tier is below Enterprise Plus — falls back to folder, surfaces clearly

Errors

• Box MCP not connected → run box-mcp-check to confirm
• 403 on template create → likely stale OAuth token; reconnect Box MCP
• 409 conflict on workspace folder → pick different name

See also

• Hubs Workspaces — what --as-hub unlocks
• Schema — _box-memory.json and _index.json shape
• Tier Matrix — what's available by tier
• Box AI Integration — the AI features box-init sets up
• Source: skills/box-init/SKILL.md