Tanq16/box-cli

<div align="center" <img src=".github/assets/logo.svg" alt="Box Logo" width="200" <h1Box</h1

<a href="https://github.com/tanq16/box-cli/actions/workflows/release.yaml"<img alt="Build Workflow" src="https://github.com/tanq16/box-cli/actions/workflows/release.yaml/badge.svg"</a&nbsp;<a href="https://github.com/tanq16/box-cli/releases"<img alt="GitHub Release" src="https://img.shields.io/github/v/release/tanq16/box-cli"</a<br<br <a href="#capabilities"Capabilities</a &bull; <a href="#installation"Installation</a &bull; <a href="#usage"Usage</a &bull; <a href="#tips-and-notes"Tips & Notes</a </div

---

A CLI tool for Box.com file operations. Single binary, cross-platform, built with Go.

Capabilities

| Category | Commands | Description | |----------|----------|-------------| | Auth | login | OAuth authentication with Box | | Files | list, upload, download, delete | Browse, upload, download, and delete files/folders | | Manage | mkdir, move, copy, info | Create folders, move/rename, copy, and inspect items | | Search | search | Server-side search with filters | | Sync | sync push, sync pull | Bidirectional sync between local and Box | | Sharing | shared-link create/get/remove/resolve | Manage shared links on items | | Collaboration | collab create/get/update/delete/pending | Manage collaborations |

Installation

Binary

Download from releases:

# Linux/macOS
curl -sL https://github.com/tanq16/box-cli/releases/latest/download/box-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m) -o box
chmod +x box
sudo mv box /usr/local/bin/

Build from Source

git clone https://github.com/tanq16/box-cli
cd box
make build

Usage

Setup

• Create a Box application at developer.box.com with OAuth 2.0 authentication
• Save your credentials:

mkdir -p ~/.config/box
cat > ~/.config/box/credentials.json <<EOF
{
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET"
}
EOF

• Authenticate (opens browser automatically):

box login
box login --manual   # paste code manually if browser doesn't work