box

Manage Box cloud files, sharing, search, metadata, and Box AI through the Box CLI.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill box-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: box
Source: https://github.com/loteiron/ZeusAgent/tree/main/skills/productivity/box
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill box-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @box/cli, and includes references (resource) components.

What problem does it solve? Working with Box cloud storage from an agent requires correct OAuth setup, careful permission handling, and knowledge of many CLI commands and API endpoints; this Skill provides the operational guidance to perform Box file, collaboration, metadata, and AI tasks safely and verifiably. ## Core Features & Use Cases - File and Folder Operations: Upload, download, version, move, rename, share, and collaborate on Box content using the Box CLI with ID-based, verified workflows. - Search, Metadata, and Box AI: Run search and metadata queries, extract structured fields with Box AI, persist results to metadata instances or JSON sidecars, and answer questions across files or Box Hubs. - Setup and Troubleshooting: Perform interactive OAuth login for same-host or headless environments, handle custom Platform Apps, webhooks, bulk operations, and common API errors. - Use Case: Ask the agent to connect a Box account, then extract invoice numbers and totals from a folder of PDF invoices using Box AI and write the results back as file metadata. ## Quick Start Connect my Box account with OAuth and summarize the files in my Contracts folder.

Frequently Asked Questions about box

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect the Box CLI with OAuth?▼

Run box login with the official CLI OAuth app for same-computer setups, or box login --code for remote and headless hosts. After the browser authorization completes, verify the actor with box users:get me before performing any operations.

How do I extract metadata from Box files with Box AI?▼

Use box ai:extract-structured with inline fields for known schemas or box ai:extract for exploratory fields. Persist flat results to the global.properties metadata instance or upload a JSON sidecar for nested data, then read the write back to verify it.

Can I use Box AI for questions across many files?▼

Direct ai:ask supports up to 25 files; for larger sets use a Box Hub with the /ai/ask endpoint and a hubs item type. Discover an existing accessible Hub first and get approval before creating or populating one.

Why does a shared Box file not appear in my root folder?▼

Folder 0 only lists the current actor's root and is not a complete access inventory. Verify the actor with box users:get me, then fetch the known file or folder ID directly or use box search to resolve it by name.

What do I do when the Box CLI lacks a command I need?▼

Use box request to call the matching REST endpoint with the CLI's configured OAuth identity. This preserves the authenticated environment and handles operations like native Box Note creation or Hub Q&A without switching tools.

What are the requirements for running the Box CLI?▼

Box CLI 4 requires Node.js 18 or newer and npm. Install @box/cli into an isolated writable directory rather than globally, and verify the installation with box --version before authenticating.