Przejdź do treści
Biblioteka skilli
Dokumenty i biuro · Automatyzacja

box-cli

/box-cli

Wykonuje operacje w Box przez oficjalne Box CLI, w tym skrypty powłoki, uwierzytelnianie, diagnostykę i zbiorcze zadania na plikach.

Autor
box ↗
Repozytorium
skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
4
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Wykonuje operacje w Box przez oficjalne Box CLI, w tym skrypty powłoki, uwierzytelnianie, diagnostykę i zbiorcze zadania na plikach.

Oryginalny opis (EN)

Use the official Box CLI for Box command-line operations, reproducible shell automation, CLI authentication or troubleshooting, and bulk Box work. Do not use for generic shell questions, Box strategy, or application code that should use a Box SDK.

Jak działa

  1. Operating workflow
  2. Common patterns
  3. Setup and authentication
  4. Risky and destructive work
  5. Bulk operations and recovery
  6. REST fallback
  7. Current public sources
Sekcje z nagłówków SKILL.md, w oryginale · 119 linii, 1 069 słów
Podgląd SKILL.md
---
name: box-cli
description: Use the official Box CLI for Box command-line operations, reproducible shell automation, CLI authentication or troubleshooting, and bulk Box work. Do not use for generic shell questions, Box strategy, or application code that should use a Box SDK.
---

# Box CLI

Use the installed Box CLI to complete and verify Box operations.

## Operating workflow

1. Identify the requested outcome, target, and actor. If the request leaves a risky target, recipient, role, impersonated user, or batch scope ambiguous, ask one focused question before running a command.
2. Confirm the intended CLI environment and acting user before the operation. If the user names an environment, inspect `box configure:environments:select --help` and select that environment before checking identity:

   ```bash
   box users:get me --json --fields id,name,login
   ```

   Include the intended `--as-user <USER_ID>` in the identity check when impersonation is authorized. `users:get me` confirms the acting user, not the environment name. Reuse the same environment and actor controls throughout the operation and its verification; repeat the check after any authorized environment or actor change. Never switch to a more privileged identity merely to bypass an error.
3. Resolve human-readable names to stable Box IDs before mutation. If multiple items match, present the candidates and ask the user to choose.
4. Prefer a dedicated CLI command. Add `--json` for machine-readable output and narrow `--fields` to the data needed for the task.
5. Verify mutations with a read using the same actor. For deletes, check the parent collection or trash as appropriate; a `404` alone can also mean the actor lacks access. For asynchronous operations, report pending status until completion is confirmed.
6. Report the actor, action, relevant object IDs, verification evidence, and any unresolved failure. Include commands when they help the user reproduce the result.

## Common patterns

Record `box --version`. Inspect command help when syntax is unfamiliar, the installed version differs from the verified version below, or a command is rejected. Resolve uncertainty before running a write.

```bash
# Identify the actor
box users:get me --json --fields id,name,login

# Inspect the root folder and a bounded set of children
box folders:get 0 --json --fields id,name
box folders:items 0 --json --fields id,type,name --max-items 20

# Search and preserve parent information for disambiguation
box search "Launch Plan" --json --fields id,type,name,parent --limit 20

# Read an item by ID
box files:get <FILE_ID> --json --fields id,name,parent,owned_by
box folders:get <FOLDER_ID> --json --fields id,name,parent,owned_by

# Create, then verify the returned folder ID
box folders:create <PARENT_FOLDER_ID> "Approved Assets" --json
box folders:get <RETURNED_FOLDER_ID> --json --fields id,name,parent
```

Box uses `0` as the root folder ID. A path or item name is not a stable identifier.

Use `box <topic>:<command> --help` to check flags and argument order in the installed version.

## Setup and authentication

Only enter setup mode when the CLI is absent, authentication fails, or the user asks for it.

```bash
npm install --global @box/cli
box login -d
```

- `box login -d` uses the official Box CLI application for interactive content operations.
- In a headless environment, have the user run `box login -d --code` in their own terminal for the official CLI app, or `box login --platform-app --code` for their custom app. `--code` is a boolean flag: the CLI displays an authorization URL, then prompts for the state and authorization code after the user authorizes in an external browser. Enter those values only at the local CLI prompts.
- Use `box login --platform-app` when the user needs a custom OAuth application or scopes beyond the official CLI application.
- For approved server automation with JWT or Client Credentials Grant, use the current `box configure:environments:add --help` flow and protect the configuration file outside source control.
- Developer tokens are for short local tests. Do not embed tokens, client secrets, private keys, or authorization codes in commands, prompts, logs, fixtures, or repository files.

After setup, verify the identity with `box users:get me`; do not print credential stores or raw environment configuration.

## Risky and destructive work

The request must explicitly authorize the exact scope before:

- deleting or permanently deleting content;
- creating, changing, or removing collaborations or shared links;
- impersonating another user;
- changing enterprise users, groups, retention, or governance settings; or
- running a broad batch that can alter many objects.

If that authorization is absent, show the actor, target IDs, proposed role or change, and batch size, then ask for confirmation. Do not rely on CLI prompts because some destructive commands do not prompt.

Run dependent writes serially. Serialize processes sharing an OAuth environment to avoid overlapping token refreshes or environment changes. Verify using returned IDs.

## Bulk operations and recovery

Use CSV or JSON input through `--bulk-file-path` only when the specific command supports that flag. Check the command's help and official bulk examples for supported columns and nested values. Before executing a batch:

1. Validate input columns against the command's arguments and flags. Row values override command-line values, including `as-user`; inspect actor and target overrides before execution.
2. Validate a small representative subset when the operation is reversible and the user has authorized it.
3. Keep a reconciliation record separate from the CLI input, with source-row number or key, intended target ID, actor, and outcome. Do not add tracking columns the command does not support.
4. Capture output and per-row error diagnostics. Bulk execution can continue after row failures and finish without a nonzero exit status; reconcile each row before reporting success.

For partial failures:

- Treat successful rows as committed until verification proves otherwise.
- Retry `429` responses only after the indicated delay.
- Retry timeouts or `5xx` responses only when the operation is idempotent or a read proves the mutation did not occur.
- Do not retry `401`, `403`, or ambiguous writes unchanged. Correct identity, permission, or state first.
- Retry only the verified-safe failed subset, then reconcile every source row against Box.

Never restart an entire partially successful mutation batch merely because some rows failed.

## REST fallback

When no dedicated command exists, prefer `box request` because it reuses the selected CLI identity:

```bash
box request /folders/0/items --query "limit=5" --json
```

Inspect `box request --help` before a write. Use explicit method, body, and query values, then verify the resulting Box object through a read. Raw `curl` with a bearer token is outside the normal workflow and should be used only when the user supplies an approved secure authentication mechanism.

## Current public sources

Use these sources when installed help is insufficient:

- [Box CLI repository and installation](https://github.com/box/boxcli)
- [Box CLI authentication](https://github.com/box/boxcli/blob/main/docs/authentication.md)
- [Box CLI command documentation](https://github.com/box/boxcli/tree/main/docs)
- [Box Developer CLI guides](https://developer.box.com/guides/cli/)

Examples and authentication flags checked on 2026-10-13 against the public Box CLI source and docs at commit `97e4351cb5e4a2077f37090bb5aca0ae2fe7020f` (package version `4.10.1`).

Wersje

W bazie nie ma innych skilli o nazwie box-cli.

Migawka bazy z 13.11.2026 · wersja paczki f5cd28bd7819 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100box-cloud-filesystem
    Zarządza plikami w Box przez oficjalne Box CLI: wyszukuje, pobiera, wgrywa, aktualizuje wersje, udostępnia i synchronizuje zawartość z potwierdzeniami operacji.
  • 100box
    Obsługuje podstawy pracy z Box: uwierzytelnianie, konfiguracja MCP i CLI, wybór między MCP, CLI i REST, limity zapytań, diagnoza błędów 401, 403, 404, 409 i 429 oraz narzędzia MCP Box.
  • 90box-mcp
    Łączy klientów z hostowanym serwerem MCP Box i obsługuje Box przez jego narzędzia, w tym konfigurację, uwierzytelnianie i brakujące narzędzia.
  • 100box
    Obsługuje pliki, foldery i dyski w Box przez ujednolicone API File Storage Apideck, z przełączaniem konektorów zmianą serviceId.
  • 100shell-expert
    Wspiera skrypty powłoki w bash, zsh i POSIX, narzędzia CLI i automatyzację międzyplatformową, w tym potoki i przenośny kod powłoki.
  • 90upstash-box-cli
    Steruje Upstash Box, zdalnym izolowanym środowiskiem, z terminala przez CLI box: polecenia, edycja plików, klonowanie repozytoriów, buildy i testy, publiczny URL, zrzuty stron, pull requesty i harmonogramy.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.