Repo: ra-infrastructure (private)
CLI entry point: inv (installed via pip install -e ".[dev]")
Framework: Typer 0.9+
Language: Python 3.11+
Personal infrastructure repository managing 10+ Docker containers. The inv CLI provides a full inventory management system for organizations, sites, zones, devices, networks, and database operations.
Global Options
| Option | Description |
|---|
--help | Show command help |
Command Groups
org -- Organization Management
| Command | Description | Docs |
|---|
inv org list | List all organizations | -- |
inv org show SLUG | Show organization details | -- |
inv org create NAME | Create a new organization | -- |
inv org delete SLUG | Delete an organization | -- |
site -- Site Management
| Command | Description | Docs |
|---|
inv site list | List all sites | -- |
inv site show SLUG | Show site details | -- |
inv site create NAME | Create a new site | -- |
inv site delete SLUG | Delete a site and all its data | -- |
zone -- Zone Management
| Command | Description | Docs |
|---|
inv zone list | List zones | -- |
inv zone show SLUG | Show zone details | -- |
inv zone create NAME | Create a new zone | -- |
inv zone delete SLUG | Delete a zone | -- |
inv zone types | List zone type options | -- |
device -- Device Management
| Command | Description | Docs |
|---|
inv device list | List devices with filtering | View |
inv device show SLUG | Show device details | -- |
inv device create NAME | Create a new device | -- |
inv device count | Count devices by category, type, zone, status, or usage | -- |
inv device update SLUG | Update device properties | -- |
inv device delete SLUG | Delete a device | -- |
inv device store SLUG | Mark device as stored | -- |
inv device activate SLUG | Mark device as active | -- |
inv device fail SLUG | Mark device as failed | -- |
inv device retire SLUG | Mark device as retired | -- |
inv device pending SLUG | Mark device as pending | -- |
network -- Network Management
| Command | Description | Docs |
|---|
inv network list | List networks | -- |
inv network show SLUG | Show network details | -- |
inv network types | List network type options | -- |
inv network ips NETWORK | List IP allocations for a network | -- |
inv network create NAME | Create a new network | -- |
inv network delete SLUG | Delete a network | -- |
db -- Database Operations
| Command | Description | Docs |
|---|
inv db health | Check database health status | View |
inv db status | Show detailed database status | -- |
inv db start | Start the database container | -- |
inv db stop | Stop the database container | -- |
inv db restart | Restart the database container | -- |
inv db watch | Watch database health with notifications | -- |
inv db migrate | Run database migrations | -- |
inv db seed | Seed database with initial data | -- |
inv db reset | Reset database (drop all, re-migrate) | -- |
inv db tables | List all database tables | -- |
inv db stats | Show database statistics | -- |
inv db schema | Generate schema diagram (SchemaSpy) | -- |
system -- System Health
| Command | Description | Docs |
|---|
inv system selfcheck | Comprehensive health check of all services | -- |
inv system check-endpoint URL | Check a specific HTTP/HTTPS endpoint | -- |
Standalone
| Command | Description |
|---|
inv version | Show version |
inv status | Show system status and database connection |
Prerequisites
- Python 3.11+
pip install -e ".[dev]" from cli/ directory- PostgreSQL container running (via Docker Compose)
- Docker Desktop for database and service containers