box

Manage Box cloud files, sharing, search, metadata, and Box AI document workflows via CLI.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill box-chenhui-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: box
Source: https://github.com/CHENHUI-X/toolbox/tree/main/official-skills/productivity/box
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill box-chenhui-x

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 AI assistant normally requires manual API calls, ad-hoc scripts, and risky handling of OAuth credentials. This Skill provides a complete operational playbook for connecting a Box account through OAuth and performing file, folder, sharing, search, metadata, and Box AI tasks safely through the official Box CLI. ## Core Features & Use Cases - OAuth Connection Setup: Guides interactive Box CLI login for both same-computer and remote/headless environments, including custom OAuth Platform Apps when extra scopes like webhook management are needed. - Content Operations: Upload, download, version, move, rename, share, and collaborate on Box files and folders using ID-based commands with verification after every write. - Search, Metadata & Box AI: Run Box search and metadata queries, extract structured metadata from documents with Box AI, persist results to global.properties or JSON sidecars, and run Q&A over files or Box Hubs. - Bulk & App Workflows: Inventory-driven batch operations with recovery from 409/429 errors, plus SDK guidance for building Box-backed applications and webhook handlers. - Use Case: Ask the assistant to connect your Box account, then extract invoice numbers and totals from every PDF in a Box folder and write the results back as file metadata. ## Quick Start Connect my Box account with OAuth and summarize the files in my Box folder.

Frequently Asked Questions about box

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

FAQPage Schema
How do I connect a Box account to an AI assistant with OAuth?

Use the Box CLI login flow: run `box login --default-box-app` for a same-computer browser, or `box login --default-box-app --code` when the assistant runs on a remote or headless host. After authorization, verify the connected identity with `box users:get me`.

How do I extract metadata from files stored in Box?

Use Box AI extraction commands: `ai:extract-structured` for known fields, `ai:extract` for exploratory fields, then persist results to the built-in `global.properties` metadata instance or a JSON sidecar file. Always read the metadata back and compare it with the intended values.

Can I run Box CLI commands on a headless server or VPS?

Yes, use the remote OAuth path with `box login --code`, which displays a URL to authorize in a browser on another computer and returns a code and state to the waiting CLI. Do not use the local callback flow when the browser is on a different host.

What is the difference between Box AI ask and Box Hubs for document Q&A?

Box AI `ai:ask` handles Q&A over up to 25 selected files, while Box Hubs support recurring Q&A over a curated, indexed knowledge base of many more files. Hubs must have AI enabled before creation so their content gets indexed.

Why does Box AI return 404 for a file I can download?

A file accessible via `files:get` can still fail through Box AI if the feature is disabled, the account lacks AI units, or the OAuth app is missing the AI scope. Verify the actor and file permissions first, then check Box AI enablement before retrying.

Can I create Box metadata templates through the CLI?

No, Box does not permit creating global templates, and enterprise template creation requires a Box Admin or authorized Co-Admin. Store flat extraction results in the schema-free `global.properties` instance or upload a JSON sidecar instead.