borealhost 0.1.0__tar.gz

borealhost-0.1.0/.gitignore

@@ -0,0 +1,36 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+venv/
+.pytest_cache/
+db.sqlite3
+
+# Node
+node_modules/
+dist/
+bun.lock
+
+# Secrets
+.env
+*.key
+*.pem
+secrets/
+.ssh/
+
+# Claude Code
+.claude/
+.mcp.json
+
+# Deploy artifacts & large files
+*.tar.gz
+*.tar
+*.mo
+
+# Backups
+*.bak.*
+
+# OS
+.DS_Store
+*.swp
+*~

borealhost-0.1.0/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: borealhost
+Version: 0.1.0
+Summary: Command-line tool for BorealHost.ai — agent-native web hosting
+Project-URL: Homepage, https://borealhost.ai
+Project-URL: Documentation, https://borealhost.ai/api/v1/docs/
+Project-URL: Repository, https://github.com/alainsvrd/platform
+Author-email: BorealHost <hello@borealhost.ai>
+License: MIT
+Keywords: borealhost,cli,hosting
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.10
+Requires-Dist: borealhost-sdk>=0.1.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.12.0
+Description-Content-Type: text/markdown
+
+# BorealHost CLI (`bh`)
+
+Command-line tool for [BorealHost.ai](https://borealhost.ai) — agent-native web hosting.
+
+## Install
+
+```bash
+pip install borealhost
+```
+
+## Authenticate
+
+```bash
+bh auth register                     # new agent account
+bh auth set-key bh_your_existing_key # existing account
+bh auth whoami
+```
+
+Keys are persisted to `~/.borealhost/config.toml` (chmod 600).
+
+## Examples
+
+```bash
+# Buy hosting
+bh plans list
+bh checkout create bh_site_starter_monthly
+bh checkout update <id> --slug my-site --email you@example.com
+bh checkout complete <id>
+
+# Manage a site
+bh sites list
+bh sites status my-site
+bh sites deploy my-site
+bh files ls my-site /public_html
+bh wp plugins list my-site
+bh db query my-site wp_my_site "SELECT * FROM wp_users LIMIT 5"
+
+# Snapshots
+bh snapshots create my-site --description "before upgrade"
+bh snapshots list my-site
+
+# DNS
+bh dns add my-site --type A --value 1.2.3.4 --subdomain www
+
+# Domains
+bh domains search example.com
+bh domains register example.com --period 1
+```
+
+## Output formats
+
+All commands accept `--json`, `--yaml`, or `--table` (default for TTY):
+
+```bash
+bh sites list --json | jq '.[] | .slug'
+bh plans list --yaml > plans.yaml
+```
+
+When stdout is not a TTY, JSON is used automatically.
+
+## Environment variables
+
+- `BOREALHOST_API_KEY` — API key (overrides config file)
+- `BOREALHOST_BASE_URL` — API base URL (default: `https://borealhost.ai`)
+
+## Related
+
+- [`borealhost-sdk`](https://pypi.org/project/borealhost-sdk/) — Python SDK
+- [`borealhost-mcp`](https://pypi.org/project/borealhost-mcp/) — MCP server for AI agents

borealhost-0.1.0/README.md

@@ -0,0 +1,69 @@
+# BorealHost CLI (`bh`)
+
+Command-line tool for [BorealHost.ai](https://borealhost.ai) — agent-native web hosting.
+
+## Install
+
+```bash
+pip install borealhost
+```
+
+## Authenticate
+
+```bash
+bh auth register                     # new agent account
+bh auth set-key bh_your_existing_key # existing account
+bh auth whoami
+```
+
+Keys are persisted to `~/.borealhost/config.toml` (chmod 600).
+
+## Examples
+
+```bash
+# Buy hosting
+bh plans list
+bh checkout create bh_site_starter_monthly
+bh checkout update <id> --slug my-site --email you@example.com
+bh checkout complete <id>
+
+# Manage a site
+bh sites list
+bh sites status my-site
+bh sites deploy my-site
+bh files ls my-site /public_html
+bh wp plugins list my-site
+bh db query my-site wp_my_site "SELECT * FROM wp_users LIMIT 5"
+
+# Snapshots
+bh snapshots create my-site --description "before upgrade"
+bh snapshots list my-site
+
+# DNS
+bh dns add my-site --type A --value 1.2.3.4 --subdomain www
+
+# Domains
+bh domains search example.com
+bh domains register example.com --period 1
+```
+
+## Output formats
+
+All commands accept `--json`, `--yaml`, or `--table` (default for TTY):
+
+```bash
+bh sites list --json | jq '.[] | .slug'
+bh plans list --yaml > plans.yaml
+```
+
+When stdout is not a TTY, JSON is used automatically.
+
+## Environment variables
+
+- `BOREALHOST_API_KEY` — API key (overrides config file)
+- `BOREALHOST_BASE_URL` — API base URL (default: `https://borealhost.ai`)
+
+## Related
+
+- [`borealhost-sdk`](https://pypi.org/project/borealhost-sdk/) — Python SDK
+- [`borealhost-mcp`](https://pypi.org/project/borealhost-mcp/) — MCP server for AI agents

borealhost-0.1.0/borealhost_cli/__init__.py

@@ -0,0 +1,3 @@
+"""BorealHost CLI — `bh` command-line tool."""
+
+__version__ = "0.1.0"

borealhost-0.1.0/borealhost_cli/commands/__init__.py

@@ -0,0 +1 @@
+"""CLI command groups — one module per functional area."""

borealhost-0.1.0/borealhost_cli/commands/account.py

@@ -0,0 +1,51 @@
+"""Account management: update profile, subscriptions, billing portal."""
+
+from typing import Optional
+
+import typer
+
+from ..helpers import run
+
+app = typer.Typer(no_args_is_help=True)
+
+
+@app.command("update")
+def update_cmd(
+    ctx: typer.Context,
+    email: Optional[str] = typer.Option(None, "--email"),
+    language: Optional[str] = typer.Option(None, "--language", help="en or fr."),
+    first_name: Optional[str] = typer.Option(None, "--first-name"),
+    last_name: Optional[str] = typer.Option(None, "--last-name"),
+) -> None:
+    """Update account profile fields."""
+    cli = ctx.obj
+    run(ctx, cli.client.update_account, email=email, language=language, first_name=first_name, last_name=last_name)
+
+
+@app.command("delete")
+def delete_cmd(
+    ctx: typer.Context,
+    yes: bool = typer.Option(False, "--yes", "-y", help="Skip confirmation."),
+) -> None:
+    """Soft-delete (anonymize) the account. [red]Irreversible.[/red]"""
+    if not yes:
+        typer.confirm("Really delete this account? This cannot be undone.", abort=True)
+    cli = ctx.obj
+    run(ctx, cli.client.delete_account)
+
+
+@app.command("subscriptions")
+def subscriptions_cmd(ctx: typer.Context) -> None:
+    """List all subscriptions for the account."""
+    cli = ctx.obj
+    run(ctx, cli.client.list_subscriptions, title="Subscriptions")
+
+
+@app.command("billing-portal")
+def billing_portal_cmd(
+    ctx: typer.Context,
+    flow: Optional[str] = typer.Option(None, "--flow", help="Stripe portal flow type."),
+) -> None:
+    """Get the Stripe billing portal URL."""
+    cli = ctx.obj
+    run(ctx, cli.client.get_billing_portal, flow=flow)

borealhost-0.1.0/borealhost_cli/commands/alerts.py

@@ -0,0 +1,46 @@
+"""Alert rules: list, create, delete."""
+
+import typer
+
+from ..helpers import run
+
+app = typer.Typer(no_args_is_help=True)
+
+
+@app.command("list")
+def list_cmd(ctx: typer.Context, slug: str = typer.Argument(..., help="Site slug.")) -> None:
+    """List alert rules for a site."""
+    cli = ctx.obj
+    run(ctx, cli.client.list_alert_rules, slug)
+
+
+@app.command("create")
+def create_cmd(
+    ctx: typer.Context,
+    slug: str = typer.Argument(..., help="Site slug."),
+    metric: str = typer.Argument(..., help="Metric: cpu, ram, disk, error_5xx, etc."),
+    threshold: float = typer.Argument(..., help="Threshold value."),
+    operator: str = typer.Option("gt", "--operator", help="gt, lt, gte, lte, eq."),
+    severity: str = typer.Option("warning", "--severity", help="info, warning, critical."),
+    cooldown_minutes: int = typer.Option(30, "--cooldown", help="Cooldown between alerts (minutes)."),
+    notify_email: bool = typer.Option(True, "--email/--no-email"),
+    notify_webhook: str = typer.Option("", "--webhook", help="Webhook URL."),
+) -> None:
+    """Create a new alert rule."""
+    cli = ctx.obj
+    run(
+        ctx, cli.client.create_alert_rule, slug, metric, threshold,
+        operator=operator, severity=severity, cooldown_minutes=cooldown_minutes,
+        notify_email=notify_email, notify_webhook=notify_webhook,
+    )
+
+
+@app.command("delete")
+def delete_cmd(
+    ctx: typer.Context,
+    slug: str = typer.Argument(..., help="Site slug."),
+    rule_id: str = typer.Argument(..., help="Alert rule ID."),
+) -> None:
+    """Delete an alert rule."""
+    cli = ctx.obj
+    run(ctx, cli.client.delete_alert_rule, slug, rule_id)

borealhost-0.1.0/borealhost_cli/commands/apps.py

@@ -0,0 +1,43 @@
+"""App installation on VPS sites (Ghost, WordPress, etc)."""
+
+import typer
+
+from ..helpers import run
+
+app = typer.Typer(no_args_is_help=True)
+
+
+@app.command("list")
+def list_cmd(ctx: typer.Context, slug: str = typer.Argument(..., help="Site slug.")) -> None:
+    """List installed apps on a VPS site."""
+    cli = ctx.obj
+    run(ctx, cli.client.list_apps, slug)
+
+
+@app.command("install")
+def install_cmd(
+    ctx: typer.Context,
+    slug: str = typer.Argument(..., help="Site slug."),
+    template: str = typer.Argument(..., help="Template name (e.g. 'ghost', 'wordpress')."),
+    app_name: str = typer.Argument(..., help="Unique app identifier within the site."),
+    db_type: str = typer.Option("none", "--db", help="Database: none, mysql, postgres."),
+    domain: str = typer.Option("", "--domain", help="Custom domain for this app."),
+    display_name: str = typer.Option("", "--display-name", help="Human-readable name."),
+) -> None:
+    """Install an app template on a VPS site."""
+    cli = ctx.obj
+    run(
+        ctx, cli.client.install_app, slug, template, app_name,
+        db_type=db_type, domain=domain, display_name=display_name,
+    )
+
+
+@app.command("status")
+def status_cmd(
+    ctx: typer.Context,
+    slug: str = typer.Argument(..., help="Site slug."),
+    app_id: str = typer.Argument(..., help="App ID from `apps list`."),
+) -> None:
+    """Get install status and logs for an app."""
+    cli = ctx.obj
+    run(ctx, cli.client.get_app, slug, app_id)

borealhost-0.1.0/borealhost_cli/commands/auth.py

@@ -0,0 +1,91 @@
+"""Authentication commands: register, set-key, whoami, request-key, claim-key."""
+
+from typing import Optional
+
+import typer
+
+from ..config import load, save
+from ..helpers import run
+from ..output import emit, success, info
+
+app = typer.Typer(no_args_is_help=True)
+
+
+@app.command("register")
+def register_cmd(
+    ctx: typer.Context,
+    name: str = typer.Option("Agent Key", "--name", help="Human-readable key name."),
+    email: Optional[str] = typer.Option(None, "--email", help="Email to link to a human account."),
+    save_key: bool = typer.Option(True, "--save/--no-save", help="Persist the new key to the config file."),
+) -> None:
+    """Register a new agent account and receive an API key."""
+    cli = ctx.obj
+    result = cli.client.register(email=email, name=name)
+    if result and result.get("api_key"):
+        key = result["api_key"]
+        cli.client.set_api_key(key)
+        if save_key:
+            data = load()
+            data["api_key"] = key
+            save(data)
+            success(f"Saved new API key ({key[:10]}...) to ~/.borealhost/config.toml")
+    emit(result, cli.output_format)
+
+
+@app.command("set-key")
+def set_key_cmd(
+    ctx: typer.Context,
+    api_key: str = typer.Argument(..., help="Your BorealHost API key (bh_...)."),
+) -> None:
+    """Save an existing API key to ~/.borealhost/config.toml."""
+    if not api_key.startswith("bh_"):
+        typer.echo("error: keys must start with 'bh_'", err=True)
+        raise typer.Exit(1)
+    data = load()
+    data["api_key"] = api_key
+    save(data)
+    success(f"Saved API key ({api_key[:10]}...) to ~/.borealhost/config.toml")
+
+
+@app.command("whoami")
+def whoami_cmd(ctx: typer.Context) -> None:
+    """Show the account associated with the current API key."""
+    cli = ctx.obj
+    run(ctx, cli.client.whoami, title="Account")
+
+
+@app.command("request-key")
+def request_key_cmd(
+    ctx: typer.Context,
+    site_slug: str = typer.Argument(..., help="Site slug (you must be running on this container)."),
+) -> None:
+    """Request a claim token for challenge-response key provisioning (on-container)."""
+    cli = ctx.obj
+    run(ctx, cli.client.request_api_key, site_slug)
+
+
+@app.command("claim-key")
+def claim_key_cmd(
+    ctx: typer.Context,
+    token: str = typer.Argument(..., help="Claim token from ~/.borealhost/.claim_token on the container."),
+    save_key: bool = typer.Option(True, "--save/--no-save", help="Persist the new key to the config file."),
+) -> None:
+    """Claim an API key with a claim token from the container."""
+    cli = ctx.obj
+    result = cli.client.claim_api_key(token)
+    if result and result.get("api_key"):
+        key = result["api_key"]
+        cli.client.set_api_key(key)
+        if save_key:
+            data = load()
+            data["api_key"] = key
+            save(data)
+            success(f"Saved claimed API key to ~/.borealhost/config.toml")
+    emit(result, cli.output_format)
+
+
+@app.command("config-path")
+def config_path_cmd() -> None:
+    """Print the path to the CLI config file."""
+    from ..config import CONFIG_PATH
+    info(str(CONFIG_PATH))

borealhost-0.1.0/borealhost_cli/commands/backups.py

@@ -0,0 +1,35 @@
+"""VPS backups: list, create, restore."""
+
+import typer
+
+from ..helpers import run
+
+app = typer.Typer(no_args_is_help=True)
+
+
+@app.command("list")
+def list_cmd(ctx: typer.Context, slug: str = typer.Argument(..., help="Site slug.")) -> None:
+    """List backups for a site."""
+    cli = ctx.obj
+    run(ctx, cli.client.list_backups, slug)
+
+
+@app.command("create")
+def create_cmd(ctx: typer.Context, slug: str = typer.Argument(..., help="Site slug.")) -> None:
+    """Create a new backup."""
+    cli = ctx.obj
+    run(ctx, cli.client.create_backup, slug)
+
+
+@app.command("restore")
+def restore_cmd(
+    ctx: typer.Context,
+    slug: str = typer.Argument(..., help="Site slug."),
+    backup_id: str = typer.Argument(..., help="Backup ID."),
+    yes: bool = typer.Option(False, "--yes", "-y", help="Skip confirmation."),
+) -> None:
+    """Restore a backup. [red]Overwrites current state.[/red]"""
+    if not yes:
+        typer.confirm(f"Restore '{slug}' from backup {backup_id}?", abort=True)
+    cli = ctx.obj
+    run(ctx, cli.client.restore_backup, slug, backup_id)

borealhost-0.1.0/borealhost_cli/commands/cache.py

@@ -0,0 +1,32 @@
+"""Cache management: status, flush, toggle."""
+
+import typer
+
+from ..helpers import run
+
+app = typer.Typer(no_args_is_help=True)
+
+
+@app.command("status")
+def status_cmd(ctx: typer.Context, slug: str = typer.Argument(..., help="Site slug.")) -> None:
+    """Show cache status for a site."""
+    cli = ctx.obj
+    run(ctx, cli.client.get_cache_status, slug)
+
+
+@app.command("flush")
+def flush_cmd(ctx: typer.Context, slug: str = typer.Argument(..., help="Site slug.")) -> None:
+    """Flush all cache for a site."""
+    cli = ctx.obj
+    run(ctx, cli.client.flush_cache, slug)
+
+
+@app.command("toggle")
+def toggle_cmd(
+    ctx: typer.Context,
+    slug: str = typer.Argument(..., help="Site slug."),
+    enable: bool = typer.Argument(..., help="true to enable, false to disable."),
+) -> None:
+    """Enable or disable caching for a site."""
+    cli = ctx.obj
+    run(ctx, cli.client.toggle_cache, slug, enable)

borealhost-0.1.0/borealhost_cli/commands/checkout.py

@@ -0,0 +1,64 @@
+"""ACP checkout flow: create, update, complete, status."""
+
+from typing import Optional
+
+import typer
+
+from ..helpers import run
+
+app = typer.Typer(no_args_is_help=True)
+
+
+@app.command("create")
+def create_cmd(
+    ctx: typer.Context,
+    sku: str = typer.Argument(..., help="Plan SKU (e.g. 'bh_site_starter_monthly')."),
+) -> None:
+    """Start a checkout session for a plan SKU."""
+    cli = ctx.obj
+    run(ctx, cli.client.create_checkout, sku, title="Checkout")
+
+
+@app.command("update")
+def update_cmd(
+    ctx: typer.Context,
+    checkout_id: str = typer.Argument(..., help="Checkout session ID."),
+    slug: Optional[str] = typer.Option(None, "--slug", help="Requested site slug."),
+    email: Optional[str] = typer.Option(None, "--email", help="Buyer email."),
+) -> None:
+    """Set buyer email and/or desired site slug on a checkout."""
+    cli = ctx.obj
+    run(ctx, cli.client.update_checkout, checkout_id, buyer_email=email, requested_slug=slug)
+
+
+@app.command("complete")
+def complete_cmd(
+    ctx: typer.Context,
+    checkout_id: str = typer.Argument(..., help="Checkout session ID."),
+    payment_method: str = typer.Option(
+        "stripe_checkout", "--payment-method",
+        help="stripe_checkout (hosted URL) or stripe_payment_method.",
+    ),
+    payment_method_id: Optional[str] = typer.Option(
+        None, "--payment-method-id", help="Stripe pm_... (for stripe_payment_method)."
+    ),
+) -> None:
+    """Complete checkout and start provisioning."""
+    cli = ctx.obj
+    run(
+        ctx,
+        cli.client.complete_checkout,
+        checkout_id,
+        payment_method=payment_method,
+        payment_method_id=payment_method_id,
+    )
+
+
+@app.command("status")
+def status_cmd(
+    ctx: typer.Context,
+    checkout_id: str = typer.Argument(..., help="Checkout session ID."),
+) -> None:
+    """Poll the status of a checkout (used after stripe_checkout payment)."""
+    cli = ctx.obj
+    run(ctx, cli.client.get_checkout, checkout_id, title="Checkout status")

borealhost-0.1.0/borealhost_cli/commands/cloudflare.py

@@ -0,0 +1,49 @@
+"""Cloudflare CDN: proxy status, cache purge, analytics."""
+
+from typing import List, Optional
+
+import typer
+
+from ..helpers import run
+
+app = typer.Typer(no_args_is_help=True)
+
+
+@app.command("proxy-status")
+def proxy_status_cmd(ctx: typer.Context, slug: str = typer.Argument(..., help="Site slug.")) -> None:
+    """Show Cloudflare proxy status for a site."""
+    cli = ctx.obj
+    run(ctx, cli.client.cf_proxy_status, slug)
+
+
+@app.command("proxy-set")
+def proxy_set_cmd(
+    ctx: typer.Context,
+    slug: str = typer.Argument(..., help="Site slug."),
+    proxied: bool = typer.Argument(..., help="true to proxy through CF, false for DNS-only."),
+) -> None:
+    """Toggle Cloudflare proxying on/off for a site."""
+    cli = ctx.obj
+    run(ctx, cli.client.cf_set_proxy, slug, proxied)
+
+
+@app.command("cache-purge")
+def cache_purge_cmd(
+    ctx: typer.Context,
+    slug: str = typer.Argument(..., help="Site slug."),
+    url: Optional[List[str]] = typer.Option(None, "--url", help="Specific URLs to purge (repeat). Default: purge all."),
+) -> None:
+    """Purge Cloudflare cache for a site."""
+    cli = ctx.obj
+    run(ctx, cli.client.cf_cache_purge, slug, urls=list(url) if url else None)
+
+
+@app.command("analytics")
+def analytics_cmd(
+    ctx: typer.Context,
+    slug: str = typer.Argument(..., help="Site slug."),
+    minutes: int = typer.Option(1440, "--minutes", help="Time window in minutes."),
+) -> None:
+    """Get Cloudflare analytics for a site."""
+    cli = ctx.obj
+    run(ctx, cli.client.cf_analytics, slug, minutes=minutes)

borealhost-0.1.0/borealhost_cli/commands/cron.py

@@ -0,0 +1,37 @@
+"""Cron jobs: list, add, delete."""
+
+import typer
+
+from ..helpers import run
+
+app = typer.Typer(no_args_is_help=True)
+
+
+@app.command("list")
+def list_cmd(ctx: typer.Context, slug: str = typer.Argument(..., help="Site slug.")) -> None:
+    """List cron jobs for a site."""
+    cli = ctx.obj
+    run(ctx, cli.client.list_cron, slug)
+
+
+@app.command("add")
+def add_cmd(
+    ctx: typer.Context,
+    slug: str = typer.Argument(..., help="Site slug."),
+    schedule: str = typer.Argument(..., help="Cron schedule, e.g. '0 * * * *'."),
+    command: str = typer.Argument(..., help="Command to run."),
+) -> None:
+    """Add a cron job."""
+    cli = ctx.obj
+    run(ctx, cli.client.add_cron, slug, schedule, command)
+
+
+@app.command("delete")
+def delete_cmd(
+    ctx: typer.Context,
+    slug: str = typer.Argument(..., help="Site slug."),
+    line_number: int = typer.Argument(..., help="Crontab line number."),
+) -> None:
+    """Delete a cron job by line number."""
+    cli = ctx.obj
+    run(ctx, cli.client.delete_cron, slug, line_number)