oph - OpenHealth CLI

A universal command-line tool for the OpenHealth development team. Replaces the Makefile with a more ergonomic and feature-rich CLI.

Installation

From source

cd tools/oph
cargo install --path .

Development build

cd tools/oph
cargo build --release
# Binary will be at target/release/oph

Usage

oph <COMMAND> [OPTIONS]

Development Environment

oph dev setup       # Initial setup (copy .env, generate SSL certs)
oph dev up          # Start all services
oph dev down        # Stop all services
oph dev restart     # Restart all services
oph dev status      # Show service status
oph dev logs        # View all logs (follow mode)
oph dev logs api    # View logs for specific service
oph dev shell db    # Open shell in container
oph dev rebuild     # Rebuild and restart services
oph dev clean       # Stop and remove volumes (destroys data)
oph dev generate    # Regenerate docker-compose.yml

Production Environment

oph prod setup        # Initial setup
oph prod ssl          # Initialize Let's Encrypt SSL
oph prod up           # Start all services
oph prod down         # Stop all services
oph prod restart      # Restart all services
oph prod status       # Show service status
oph prod logs         # View all logs
oph prod logs nginx   # View nginx logs
oph prod shell db     # Open shell in container
oph prod reload-nginx # Reload nginx config
oph prod renew-ssl    # Force SSL renewal
oph prod clean        # Stop and remove volumes
oph prod generate     # Regenerate docker-compose.yml

Database Operations

oph db shell          # Open psql shell (development)
oph db shell --prod   # Open psql shell (production)
oph db backup         # Backup dev database
oph db backup --prod  # Backup prod database
oph db restore FILE   # Restore dev database
oph db restore FILE --prod  # Restore prod database

Bun Scripts

oph run dev           # Start dev server (bun run dev)
oph run test          # Run all tests
oph run test:unit     # Run unit tests
oph run test:integration  # Run integration tests
oph run lint          # Run linter
oph run typecheck     # Run TypeScript type checking
oph run script <name> # Run any script from package.json

Redis

oph redis cli         # Open Redis CLI (development)
oph redis cli --prod  # Open Redis CLI (production)

Storage

oph storage console        # Show dev console URL
oph storage console --prod # Show prod console info

Validation

oph validate dev      # Validate dev docker-compose
oph validate prod     # Validate prod docker-compose

Docker Cleanup

oph clean images      # Remove unused images
oph clean all         # Remove all unused resources

Shell Completions

# Bash
oph completions bash > ~/.local/share/bash-completion/completions/oph

# Zsh
oph completions zsh > ~/.zfunc/_oph

# Fish
oph completions fish > ~/.config/fish/completions/oph.fish

Interactive Mode

oph interactive   # or
oph i             # Opens interactive command picker

Command Mapping from Makefile

Development

# Run in development mode
cargo run -- dev up

# Build release binary
cargo build --release

# Run tests
cargo test

License

MIT