Home

magmascript

Scripting toolkit with domain-first subcommands for managing magmacrunch.com infrastructure.

Quick Start

Install

Via Homebrew (recommended):

brew install magmacrunchmedia/tap/magmascript

Via pip:

pip install magmascript

From source:

git clone https://github.com/magmacrunchmedia/magmascript.git
cd magmascript
pip install -e ".[all]"

Configure

export MAGMA_API_KEY="your-mcp-key"        # for mcp domain
export GITHUB_TOKEN=$(gh auth token)        # for gh domain
# pi domain works with no config (SSH key auth)

Use

magmascript mcp scoreboards      # game leaderboards
magmascript pi status            # Pi service statuses
magmascript gh workflows         # GitHub Actions status

Domains

Domain	Transport	What it does
MCP Domain	JSON-RPC	MusicBrainz, scores, Discogs
Pi Domain	SSH	Service management, logs
GitHub Domain	HTTPS	Workflows, issues
Media Domain	HTTPS	Multi-provider search
Scores Domain	SSH	Game high scores
Cache Domain	Local	Cache management

Features

• Caching — File-based cache with TTL (24h media, 1h scores, 5min GitHub)
• Error handling — Typed exceptions (SSHError, APIError, etc.)
• CI/CD — Tests run on every push to Python 3.11, 3.12, 3.13

Further Reading

• Configuration — all config options
• Architecture — how domains work, adding new ones
• Shell Helpers — source lib/magmascript.sh