S3 Switch

Switch between multiple .s3cfg files from the command line.

Features

• 🔄 Manage multiple S3 configurations
• ⚡ Quick switching between different S3 accounts
• 💬 Interactive prompts for easy configuration management
• 🎯 Simple and intuitive CLI interface

Installation

npm install -g s3-switch

Usage

Get Version

s3s -v
# or
s3s --version

Commands

s3s add <file> [-n, --name <name>]

Add a new S3 configuration from an existing .s3cfg file.

s3s ls

List all saved S3 configurations. The currently active configuration is marked with *.

s3s use [name]

Switch to a specific S3 configuration. If no name is provided, an interactive prompt will appear.

s3s save <name>

Save the current .s3cfg file with a specific name.

s3s rm [name]

Delete a saved S3 configuration. If no name is provided, an interactive prompt will appear.

s3s mv [-s, --source <source>] [-d, --dest <dest>]

Rename a saved S3 configuration.

Examples

# Add a new configuration
s3s add ~/.s3cfg-production --name production

# List all configurations
s3s ls

# Switch to production configuration
s3s use production

# Save current configuration
s3s save development

# Remove a configuration
s3s rm old-config

How It Works

s3-switch stores your S3 configurations in ~/.s3-switch/ and manages your active ~/.s3cfg file by copying the selected configuration to it.

Requirements

• Node.js >= 18
• s3cmd (for using the S3 configurations)

Development

This project is written in TypeScript and maintained with pnpm.

Prerequisites

• Node.js >= 18
• pnpm (recommended) or npm

Setup

pnpm install

Build

pnpm run build

Test

pnpm test

# Watch mode
pnpm run test:watch

Type Check

pnpm run typecheck

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for details.

License

MIT