organizer

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.