s3-storage-cli

Minimal Bun CLI for tracked S3 uploads.

Install:

npm install -g s3-storage-cli

Runtime requirement:

• bun must be installed because the published CLI executes with Bun

Install without global npm setup:

npx s3-storage-cli status

Quick start:

s3-storage setup
s3-storage status

Commands:

• setup prompts for required scoped config values and saves them for this CLI
• status verifies env, SQLite, and S3 connectivity
• list shows only objects tracked by this CLI
• upload uploads one or more files or directories, with optional --name for single-file remote renames
• delete removes tracked objects
• share returns a direct public URL or a signed private URL

Scoped config keys used by this CLI:

• S3_STORAGE_CLI_ENDPOINT
• S3_STORAGE_CLI_REGION
• S3_STORAGE_CLI_ACCESS_KEY_ID
• S3_STORAGE_CLI_SECRET_ACCESS_KEY
• S3_STORAGE_CLI_BUCKET

Required for full readiness and public sharing:

• S3_STORAGE_CLI_PUBLIC_BASE_URL

Optional env:

• S3_STORAGE_CLI_DB_PATH
• S3_STORAGE_CLI_SHARE_TTL_SECONDS
• S3_STORAGE_CLI_SESSION_TOKEN
• S3_STORAGE_CLI_VIRTUAL_HOSTED_STYLE
• S3_STORAGE_CLI_ENV_PATH

setup writes the required scoped config to the CLI-owned env file under ~/.s3-storage-cli/config.env by default.

Examples:

s3-storage setup
s3-storage upload ./file.txt
s3-storage upload ./file.txt --name invoice.txt
s3-storage upload ./assets --public --prefix site
s3-storage list
s3-storage share site/assets/logo.png
s3-storage delete site/assets/logo.png

Agent Skill

This repo is also compatible with skills.sh style skill installers.

List the skill from GitHub:

npx skills add muneebhashone/s3-storage-cli -l

Install the skill:

npx skills add muneebhashone/s3-storage-cli --skill s3-storage-cli