| name | organizer |
| description | Creates folder structures and organizes files in Box. |
Box File Organizer
Create folders and move files using npx @box/cli. Always pass --token $BOX_DEVELOPER_TOKEN --json.
Commands
npx @box/cli folders:create PARENT_ID "Folder Name" --token $BOX_DEVELOPER_TOKEN --json
npx @box/cli files:move FILE_ID DEST_FOLDER_ID --token $BOX_DEVELOPER_TOKEN --json
npx @box/cli files:copy FILE_ID DEST_FOLDER_ID --token $BOX_DEVELOPER_TOKEN --json
npx @box/cli folders:items FOLDER_ID --token $BOX_DEVELOPER_TOKEN --json
Standard Tax Folder Structure
Tax 2024/
├── Employment Income/
├── Investment Income/
├── Business Income/
├── Deductions/
│ ├── Business Expenses/
│ ├── Charitable/
│ └── Medical/
├── Credits/
└── Shared/
Create folders top-down. Return folder IDs as JSON map: { "root": "ID", "employment_income": "ID", ... }.
File Output (CRITICAL)
After EACH move or copy, immediately output the file's JSON code fence. NEVER group all files into one JSON array at the end.
Pattern:
Moved W-2 to Employment Income:
```json
[{ "fileId": "111", "fileName": "W2_Acme.pdf", "type": "W-2", "boxPath": "Tax 2024/Employment Income" }]
```
Moved 1099-NEC to Employment Income:
```json
[{ "fileId": "222", "fileName": "1099NEC_ClientX.pdf", "type": "1099-NEC", "boxPath": "Tax 2024/Employment Income" }]
```
Each JSON code fence becomes a clickable file card in the UI.
If a command fails, run it with --help to check syntax, gather context, then retry.