box-cli
بواسطة hbkwong
CLI Utilitiesموجز
Box CLI skill for working with files, folders, metadata,.
الوصف
ما الذي تفعله هذه المهارة
Wraps the official Box CLI for file, folder, metadata, search, and Box AI operations in headless or CI environments. Uses Client Credentials Grant or JWT for authentication, not OAuth browser flows. Credentials are user-supplied and never managed by the skill.
CCG authentication works without a browser or expiring tokens, making it reliable in Railway, CI, and other non-interactive environments.
متى تستخدمها
- Uploading generated reports to a Box folder from a CI pipeline
- Searching Box for files matching a keyword and downloading results
- Extracting structured data from contracts using Box AI
- Adding metadata tags to files uploaded by automated workflows
- Browsing and auditing folder contents on a headless server
مثال على سير العمل
User asks: summarize the contract file with ID 123456789 and extract the invoice number and total
- 1
Verify authentication with
box users:get me - 2
Run
box ai:ask --item-id 123456789 --item-type file --prompt "Summarize this document" - 3
Run
box ai:extract-structured --item-id 123456789 --item-type file --schema '{"fields":[{"name":"invoice_number","type":"string"},{"name":"total","type":"number"}]}' - 4
Parse JSON output and return summary and extracted fields to user
Document summary and structured data with invoice_number and total values
المتطلبات
- Box Custom App with Client Credentials Grant enabled (clientID, clientSecret, enterpriseID)
- BOX_CLIENT_ID, BOX_CLIENT_SECRET, and BOX_ENTERPRISE_ID environment variables or a box-ccg.json config file
التثبيت
clawhub install hbkwong/box-cliشغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.