Xe X Using Tigris

Tigris CLI

Configuration

Default Bucket

Before performing any bucket or object operations, check for the default bucket name in this order:

1. Read AGENTS.md in the project root and look for a ## Tigris Configuration section
2. If no bucket name is found, ask the user to specify one
3. Save the bucket name to AGENTS.md under a ## Tigris Configuration section:

## Tigris Configuration

- Default bucket: `<bucket-name>`

Initial Setup

First-time Tigris usage requires configuration:

# Save credentials permanently (recommended)
tigris configure

# Or start a session with OAuth
tigris login

# Verify login
tigris whoami

Bucket Operations

List Buckets

tigris buckets list
tigris ls

Create Bucket

tigris buckets create <bucket-name>
tigris mk <bucket-name>

Get Bucket Details

tigris buckets get <bucket-name>
tigris stat <bucket-name>

Delete Bucket

tigris buckets delete <bucket-name>
tigris rm <bucket-name>

Update Bucket Settings

tigris buckets set <bucket-name>

Object Operations

All object operations require a bucket name. Use the default bucket from AGENTS.md or prompt the user.

Upload Object (Put)

tigris objects put <bucket> <key> <file>
tigris cp <file> tigris://<bucket>/<path>

Examples:

• Upload to specific path: tigris objects put my-bucket path/to/file.jpg local.jpg
• Upload with custom key: tigris objects put my-bucket images/photo.png ./photo.png

Download Object (Get)

tigris objects get <bucket> <key>
tigris cp tigris://<bucket>/<path> <local-path>

Examples:

• Download to current dir: tigris objects get my-bucket path/to/file.jpg
• Download to specific location: tigris cp tigris://my-bucket/data.json ./local/data.json

List Objects

tigris objects list <bucket>
tigris ls <bucket>
tigris ls <bucket>/<path>

Examples:

• List all objects: tigris objects list my-bucket
• List with prefix: tigris ls my-bucket/images/

Delete Object

tigris objects delete <bucket> <key>
tigris rm <bucket>/<key>

Copy Object

tigris cp tigris://<bucket>/<src> tigris://<bucket>/<dest>

Move Object

tigris mv tigris://<bucket>/<src> tigris://<bucket>/<dest>

Create Empty Object

tigris touch <bucket>/<key>

User and Account Management

User Information

tigris whoami

Logout

tigris logout

Access Keys

tigris access-keys list
tigris keys list

Quick Reference

URL Format

Tigris uses the tigris:// protocol for paths:

• tigris://<bucket>/<path> - Object in bucket
• tigris://<bucket>/ - Root of bucket

This format works with tigris cp, tigris mv, and tigris ls.

Converted and distributed by TomeVault — claim your Tome and manage your conversions.