open-index/open-npm huggingface dataset:
npm package: @outpost67/cli
Description: CLI for Outpost67 SDK
Author: Outpost67
Latest version: 1.0.0

# outpost67-cli

CLI for Outpost67 SDK

## Installation

### Linux / macOS

```bash
curl -fsSL https://github.com/filebase/outpost67-cli/releases/latest/download/install.sh | bash
```

### Windows (PowerShell)

```powershell
iwr https://github.com/filebase/outpost67-cli/releases/latest/download/install.ps1 -useb | iex
```

## Usage

### Global Options

All commands support the following global options:

- `-n, --network <network>`: Blockchain network (e.g., `evm`, `svm`).
- `-k, --key <key>`: Private key for signing transactions.

### Commands

#### Upload a File
Upload a file to the network.

```bash
outpost67 upload <name> <file> [options]
```

**Arguments:**
- `<name>`: Name to assign to the file.
- `<file>`: Path to the file to upload.

**Options:**
- `-t, --tier <tier>`: Storage tier (default: `standard`). Available tiers: `decentralized`, `fast`, `standard`, `infrequent`, `cold`.
- `-d, --duration <duration>`: Duration in hours (default: 24).

#### Retrieve a File
Retrieve a stored file.

```bash
outpost67 retrieve <idOrName> [options]
```

**Arguments:**
- `<idOrName>`: Object ID or stored name.

**Options:**
- `--token <token>`: Retrieval token (optional, defaults to wallet auth if name is stored).

#### List Files
List stored files.

```bash
outpost67 list [filter]
```

**Arguments:**
- `[filter]`: Optional regex filter.

#### Renew File Retention
Extend the retention period of a file.

```bash
outpost67 renew <idOrName> -d <duration> [options]
```

**Arguments:**
- `<idOrName>`: Object ID or stored name.

**Options:**
- `-d, --duration <duration>`: Duration to extend in hours (required).
- `--token <token>`: Renewal token (optional).

#### Rotate Tokens
Rotate access tokens for a file.

```bash
outpost67 rotate <idOrName> [options]
```

**Arguments:**
- `<idOrName>`: Object ID or stored name.

**Options:**
- `--token <token>`: specific token to rotate (optional).

#### Delete a File
Delete a file from storage.

```bash
outpost67 delete <idOrName> [options]
```

**Arguments:**
- `<idOrName>`: Object ID or stored name.

**Options:**
- `--token <token>`: Delete token (optional).

#### Restore from Cold Storage
Restore a file from a cold storage tier.

```bash
outpost67 restore <idOrName> -n <name> -d <duration> [options]
```

**Arguments:**
- `<idOrName>`: Object ID or stored name.

**Options:**
- `-n, --name <name>`: New object name (required).
- `-d, --duration <duration>`: Duration to restore in hours to a new `standard` tier object (required).
- `--token <token>`: Restore token (optional).

#### Get a Quote
Get a price quote for storage.

```bash
outpost67 quote -t <tier> -d <duration> -s <size>
```

**Options:**
- `-t, --tier <tier>`: Storage tier (default: `standard`).
- `-d, --duration <duration>`: Duration in hours (required).
- `-s, --size <size>`: Size in bytes (required).

#### Describe Services
Describe available services and capabilities.

```bash
outpost67 describe
```