Telestack CLI

Manage your Telestack Storage from the command line.

Installation

npm install -g @telestack/cli
# or run directly
npx @telestack/cli

Setup

Configure your credentials once:

telestack config set \
  --url https://your-worker.workers.dev \
  --tenant your-tenant-id \
  --api-key your-api-key

Verify:

telestack config show

Commands

📤 Upload a file

telestack upload ./photo.jpg photos/2024/sunset.jpg --user user-123
telestack upload ./report.pdf documents/report.pdf --meta '{"version":"v2"}'

📥 Download a file

telestack download photos/2024/sunset.jpg ./local-copy.jpg

📂 List files

telestack files ls                    # All files
telestack files ls photos/2024/       # Files under prefix
telestack files ls --limit 10

🔍 Search files

telestack files search "invoice"
telestack files search "photo" --type image/jpeg

📄 Get file info

telestack files info photos/2024/sunset.jpg

🔗 Get download URL

telestack files url photos/2024/sunset.jpg

✏️ Update metadata

telestack meta photos/2024/sunset.jpg --set '{"reviewed":true,"tag":"nature"}'

📁 Move files

telestack files mv uploads/a.jpg uploads/b.jpg --dest archive/2024/

📦 Copy files

telestack files cp originals/photo.jpg --dest backups/

🗑️ Delete files

telestack files rm tmp/draft.txt                # Interactive confirmation
telestack files rm tmp/a.txt tmp/b.txt --force  # No confirmation

All Commands

| Command | Description | |---|---| | config set | Save credentials | | config show | Display current config | | config clear | Remove all credentials | | upload <local> <remote> | Upload a file | | download <remote> [local] | Download a file | | meta <remote> --set <json> | Update file metadata | | files ls [prefix] | List files | | files info <path> | Get file details | | files url <path> | Get download URL | | files search <query> | Search by name/type | | files mv <paths...> --dest <d> | Move files | | files cp <paths...> --dest <d> | Copy files | | files rm <paths...> | Delete files |