restream.io 0.3.0

CLI for interacting with the Restream.io API

restream.io CLI

Python command-line tool to interact with the Restream.io API.

Bootstrapping

Requires uv installed.

uv sync

Basic commands

• restream.io login - perform OAuth2 login flow (opens browser, listens locally).
• restream.io profile - show user profile.
• restream.io channel list - list channels.
• restream.io channel get <id> - fetch specific channel.
• restream.io event list - list events.
• restream.io version - show dynamic version derived from git tags.

Configuration

Storage Location

Tokens and configuration are stored securely in the user's platform-appropriate config directory:

• Linux/macOS: ~/.config/restream.io/
• Windows: %APPDATA%\restream.io\

The configuration directory location can be overridden using the RESTREAM_CONFIG_PATH environment variable.

Environment Variables

The following environment variables are required for OAuth2 authentication:

• RESTREAM_CLIENT_ID: OAuth2 client ID (required)
• RESTREAM_CLIENT_SECRET: OAuth2 client secret (required)

Additional optional configuration:

• RESTREAM_CONFIG_PATH: Override the default configuration directory path

Before using the login command, ensure both authentication variables are set:

export RESTREAM_CLIENT_ID="your_client_id_here"
export RESTREAM_CLIENT_SECRET="your_client_secret_here"
restream.io login

Security

• Configuration directory is created with 0o700 permissions (owner read/write/execute only)
• Token files are created with 0o600 permissions (owner read/write only)
• Tokens are stored in JSON format in tokens.json within the config directory

Development

Run tests:

uv run pytest

Roadmap

See AGENTS.md for AI agent instructions and extension points.