box

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

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill box-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: box
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/skills/productivity/box
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill box-vivekgoquest

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 agent requires correct OAuth setup, identity verification, and careful handling of sharing, metadata, and AI extraction. This Skill gives Hermes a complete operational playbook for Box so file operations, collaboration, and document intelligence run safely through the Box CLI without permission mistakes or data mishandling. ## Core Features & Use Cases - File and Folder Operations: Upload, download, version, move, rename, and organize Box content using ID-based CLI commands with read-back verification. - Search, Metadata, and Box AI: Run deterministic search and metadata queries, or use Box AI for Q&A, structured extraction, and text generation grounded in Box files. - Box Hubs and Bulk Workflows: Build curated knowledge bases with Hubs for large-scale Q&A and execute resumable batch operations across hundreds of files. - Use Case: Connect a Box account via OAuth, then ask the agent to extract invoice numbers and totals from a folder of PDF invoices and persist the results as Box metadata. ## Quick Start Ask the agent to connect your Box account with OAuth and list the files in your root 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 agent?▼

Use the Box CLI OAuth flow with box login for same-computer setups or box login --code for remote and headless hosts. The authorized account's Box permissions define what the agent can access, so authorize an account invited only to the required files or folders.

How to extract metadata from Box files automatically?▼

Use Box AI structured extraction with inline fields for known schemas or freeform extraction for exploratory fields. Persist flat results in the global.properties metadata instance or upload a JSON sidecar for nested data, then read back and compare every field.

Can Box AI answer questions across many files?▼

Box AI Ask handles up to 25 selected files directly. For larger sets or recurring Q&A, use a Box Hub, which indexes curated content and answers through a single hubs item while respecting the querying actor's file permissions.

Does the Box CLI work on a headless server or VPS?▼

Yes, use box login --code for remote or headless environments where the authorization browser is on a different computer. The CLI displays a URL for sign-in, and you return the code and state values to the waiting process.

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

A 404 from ai:ask usually means Box AI is disabled, AI units are exhausted, or the OAuth app lacks the AI scope, not missing file permissions. Verify the actor and file permissions first, then check Box AI enablement before retrying.

What are the limitations of Box metadata templates?▼

Box does not permit creating global templates, and enterprise templates require a Box Admin or Co-Admin. Without a compatible template, store flat scalars in global.properties or upload a JSON sidecar to preserve nested types.