orkestr-cli 0.1.0__py3-none-any.whl

orkestr_cli/api.py

@@ -0,0 +1,195 @@
+"""HTTP client for the Orkestr API."""
+
+import sys
+
+import click
+import httpx
+
+from orkestr_cli import config
+
+
+def _client() -> httpx.Client:
+    headers = config.get_auth_header()
+    return httpx.Client(
+        base_url=config.get_api_url(),
+        headers=headers,
+        timeout=30.0,
+    )
+
+
+def _request(method: str, path: str, **kwargs) -> httpx.Response:
+    """Execute a request with connection error handling."""
+    try:
+        with _client() as c:
+            return getattr(c, method)(path, **kwargs)
+    except httpx.ConnectError:
+        url = config.get_api_url()
+        click.secho(f"Connection refused: {url}", fg="red", err=True)
+        click.secho("Is the API running? Check with: orkestr set-url <url>", err=True)
+        sys.exit(1)
+    except httpx.TimeoutException:
+        click.secho("Request timed out.", fg="red", err=True)
+        sys.exit(1)
+    except httpx.HTTPError as e:
+        click.secho(f"HTTP error: {e}", fg="red", err=True)
+        sys.exit(1)
+
+
+def _handle(resp: httpx.Response) -> dict | list | None:
+    if resp.status_code == 204:
+        return None
+    if resp.status_code == 401:
+        click.secho("Authentication required. Run: orkestr login <token>", fg="red", err=True)
+        sys.exit(1)
+    if resp.status_code >= 400:
+        try:
+            detail = resp.json().get("detail", resp.text)
+        except Exception:
+            detail = resp.text
+        click.secho(f"Error ({resp.status_code}): {detail}", fg="red", err=True)
+        sys.exit(1)
+    return resp.json()
+
+
+def _get(path: str, **kwargs):
+    return _handle(_request("get", path, **kwargs))
+
+
+def _post(path: str, **kwargs):
+    return _handle(_request("post", path, **kwargs))
+
+
+def _patch(path: str, **kwargs):
+    return _handle(_request("patch", path, **kwargs))
+
+
+def _delete(path: str, **kwargs):
+    return _handle(_request("delete", path, **kwargs))
+
+
+# -- Auth -------------------------------------------------------------------
+
+def me() -> dict:
+    return _get("/api/auth/me")
+
+
+# -- Helpers ----------------------------------------------------------------
+
+def resolve_project_id(name_or_id: str) -> str:
+    """Accept a project name or UUID, return the full UUID."""
+    # Already looks like a UUID
+    if len(name_or_id) >= 32 or name_or_id.count("-") >= 4:
+        return name_or_id
+    # Search by name
+    data = list_projects(limit=100)
+    for p in data.get("projects", []):
+        if p.get("name") == name_or_id:
+            return p["id"]
+    click.secho(f"Project not found: {name_or_id}", fg="red", err=True)
+    sys.exit(1)
+
+
+# -- Projects ---------------------------------------------------------------
+
+def list_projects(skip: int = 0, limit: int = 20) -> dict:
+    return _get("/api/v1/projects", params={"skip": skip, "limit": limit})
+
+
+def create_project(name: str, repo_url: str, branch: str = "main",
+                   display_name: str | None = None, description: str | None = None,
+                   env_vars: dict | None = None) -> dict:
+    payload = {"name": name, "repo_url": repo_url, "repo_branch": branch}
+    if display_name:
+        payload["display_name"] = display_name
+    if description:
+        payload["description"] = description
+    if env_vars:
+        payload["env_vars"] = env_vars
+    return _post("/api/v1/projects", json=payload)
+
+
+def get_project(project_id: str) -> dict:
+    return _get(f"/api/v1/projects/{project_id}")
+
+
+def update_project(project_id: str, **fields) -> dict:
+    return _patch(f"/api/v1/projects/{project_id}", json=fields)
+
+
+def delete_project(project_id: str):
+    _delete(f"/api/v1/projects/{project_id}")
+
+
+def analyze_project(project_id: str) -> dict:
+    return _post(f"/api/v1/projects/{project_id}/analyze")
+
+
+# -- Environments -----------------------------------------------------------
+
+def list_environments(project_id: str) -> list:
+    return _get(f"/api/v1/projects/{project_id}/environments")
+
+
+def create_environment(project_id: str, name: str, branch: str,
+                       env_vars: dict | None = None, auto_deploy: bool = True) -> dict:
+    payload = {"name": name, "branch": branch, "auto_deploy": auto_deploy}
+    if env_vars:
+        payload["env_vars"] = env_vars
+    return _post(f"/api/v1/projects/{project_id}/environments", json=payload)
+
+
+def update_environment(project_id: str, env_id: str, **fields) -> dict:
+    return _patch(f"/api/v1/projects/{project_id}/environments/{env_id}", json=fields)
+
+
+def delete_environment(project_id: str, env_id: str):
+    _delete(f"/api/v1/projects/{project_id}/environments/{env_id}")
+
+
+# -- Deployments ------------------------------------------------------------
+
+def trigger_deployment(project_id: str, environment_id: str | None = None) -> dict:
+    params = {}
+    if environment_id:
+        params["environment_id"] = environment_id
+    return _post(f"/api/v1/projects/{project_id}/deployments", params=params)
+
+
+def list_deployments(project_id: str, skip: int = 0, limit: int = 20) -> dict:
+    return _get(f"/api/v1/projects/{project_id}/deployments",
+                params={"skip": skip, "limit": limit})
+
+
+def get_deployment(deployment_id: str) -> dict:
+    return _get(f"/api/v1/deployments/{deployment_id}")
+
+
+def get_deployment_logs(deployment_id: str) -> dict:
+    return _get(f"/api/v1/deployments/{deployment_id}/logs")
+
+
+def rollback_deployment(deployment_id: str) -> dict:
+    return _post(f"/api/v1/deployments/{deployment_id}/rollback")
+
+
+# -- Monitoring -------------------------------------------------------------
+
+def get_stats(project_id: str, environment_id: str | None = None) -> dict:
+    params = {}
+    if environment_id:
+        params["environment_id"] = environment_id
+    return _get(f"/api/v1/projects/{project_id}/stats", params=params)
+
+
+def get_logs(project_id: str, environment_id: str | None = None, lines: int = 200) -> dict:
+    params = {"lines": lines}
+    if environment_id:
+        params["environment_id"] = environment_id
+    return _get(f"/api/v1/projects/{project_id}/logs", params=params)
+
+
+def get_health(project_id: str, environment_id: str | None = None) -> dict:
+    params = {}
+    if environment_id:
+        params["environment_id"] = environment_id
+    return _get(f"/api/v1/projects/{project_id}/health", params=params)

orkestr_cli/config.py

@@ -0,0 +1,79 @@
+"""Configuration and credential storage for the Orkestr CLI."""
+
+import json
+from pathlib import Path
+
+CONFIG_DIR = Path.home() / ".orkestr"
+CONFIG_FILE = CONFIG_DIR / "config.json"
+
+DEFAULTS = {
+    "api_url": "https://api.orkestr.eu",
+}
+
+
+def _ensure_dir():
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    CONFIG_FILE.touch(exist_ok=True)
+
+
+def load() -> dict:
+    _ensure_dir()
+    text = CONFIG_FILE.read_text().strip()
+    if not text:
+        return dict(DEFAULTS)
+    data = json.loads(text)
+    for k, v in DEFAULTS.items():
+        data.setdefault(k, v)
+    # Migrate old localhost default to production URL
+    if data.get("api_url") == "http://localhost:8000":
+        data["api_url"] = DEFAULTS["api_url"]
+    return data
+
+
+def save(data: dict):
+    _ensure_dir()
+    CONFIG_FILE.write_text(json.dumps(data, indent=2) + "\n")
+
+
+def get_api_url() -> str:
+    return load().get("api_url", DEFAULTS["api_url"])
+
+
+def get_auth_header() -> dict[str, str]:
+    """Return the Authorization header dict, or empty dict if not logged in."""
+    cfg = load()
+    token = cfg.get("api_token") or cfg.get("access_token")
+    if not token:
+        return {}
+    prefix = "Bearer" if cfg.get("access_token") else "Bearer"
+    return {"Authorization": f"{prefix} {token}"}
+
+
+def store_tokens(access_token: str, refresh_token: str | None = None):
+    cfg = load()
+    cfg["access_token"] = access_token
+    if refresh_token:
+        cfg["refresh_token"] = refresh_token
+    cfg.pop("api_token", None)
+    save(cfg)
+
+
+def store_api_token(token: str):
+    cfg = load()
+    cfg["api_token"] = token
+    cfg.pop("access_token", None)
+    cfg.pop("refresh_token", None)
+    save(cfg)
+
+
+def clear_auth():
+    cfg = load()
+    cfg.pop("access_token", None)
+    cfg.pop("refresh_token", None)
+    cfg.pop("api_token", None)
+    save(cfg)
+
+
+def is_logged_in() -> bool:
+    cfg = load()
+    return bool(cfg.get("access_token") or cfg.get("api_token"))

orkestr_cli/main.py

@@ -0,0 +1,511 @@
+"""Orkestr CLI — manage your projects, deployments, and infrastructure."""
+
+import click
+
+from orkestr_cli import api, config
+from orkestr_cli.output import (
+    console,
+    format_dt,
+    print_json,
+    print_kv,
+    print_table,
+    status_color,
+    truncate,
+)
+
+
+# ---------------------------------------------------------------------------
+# Root group
+# ---------------------------------------------------------------------------
+
+@click.group()
+@click.option("--api-url", envvar="ORKESTR_API_URL", help="Override API base URL.")
+@click.option("--token", envvar="ORKESTR_API_TOKEN", help="API token for auth.")
+@click.option("--json", "use_json", is_flag=True, help="Output raw JSON.")
+@click.version_option("0.1.0", prog_name="orkestr")
+@click.pass_context
+def cli(ctx, api_url, token, use_json):
+    """Orkestr CLI — deploy and manage your applications."""
+    ctx.ensure_object(dict)
+    ctx.obj["json"] = use_json
+
+    if api_url:
+        cfg = config.load()
+        cfg["api_url"] = api_url
+        config.save(cfg)
+
+    if token:
+        config.store_api_token(token)
+
+
+# ---------------------------------------------------------------------------
+# Auth commands
+# ---------------------------------------------------------------------------
+
+@cli.command()
+@click.option("--token", prompt="API token", hide_input=True, prompt_required=True,
+              help="API token (will be prompted if not provided).")
+def login(token):
+    """Authenticate with an API token.
+
+    Generate a token from the Orkestr dashboard under Settings > API Tokens.
+    """
+    token = token.strip()
+    if not token:
+        click.secho("Token cannot be empty.", fg="red", err=True)
+        raise SystemExit(1)
+    config.store_api_token(token)
+    data = api.me()
+    click.secho(f"Logged in as {data.get('username', 'unknown')}.", fg="green")
+
+
+@cli.command()
+def logout():
+    """Clear stored credentials."""
+    config.clear_auth()
+    click.secho("Logged out.", fg="green")
+
+
+@cli.command()
+@click.pass_context
+def whoami(ctx):
+    """Show current user info."""
+    data = api.me()
+    if ctx.obj["json"]:
+        print_json(data)
+        return
+    print_kv([
+        ("Username:", data.get("username", "-")),
+        ("Email:", data.get("email", "-")),
+        ("Plan:", data.get("plan", "-")),
+        ("Active:", str(data.get("is_active", "-"))),
+        ("Created:", format_dt(data.get("created_at"))),
+    ])
+
+
+@cli.command("set-url")
+@click.argument("url")
+def set_url(url):
+    """Set the API base URL."""
+    cfg = config.load()
+    cfg["api_url"] = url.rstrip("/")
+    config.save(cfg)
+    click.secho(f"API URL set to {cfg['api_url']}", fg="green")
+
+
+
+# ---------------------------------------------------------------------------
+# Projects
+# ---------------------------------------------------------------------------
+
+@cli.group()
+def projects():
+    """Manage projects."""
+
+
+@projects.command("list")
+@click.option("--limit", default=20, help="Max results.")
+@click.pass_context
+def projects_list(ctx, limit):
+    """List all projects."""
+    data = api.list_projects(limit=limit)
+    if ctx.obj["json"]:
+        print_json(data)
+        return
+
+    rows = []
+    for p in data.get("projects", []):
+        rows.append([
+            p.get("name", "-"),
+            p.get("display_name") or p.get("name", "-"),
+            p.get("framework") or "-",
+            status_color(p.get("status", "-")),
+            format_dt(p.get("created_at")),
+        ])
+    print_table("Projects", ["Name", "Display Name", "Framework", "Status", "Created"], rows)
+    click.echo(f"\nTotal: {data.get('total', len(rows))}")
+
+
+@projects.command("create")
+@click.argument("name")
+@click.option("--repo", required=True, help="Git repository URL.")
+@click.option("--branch", default="main", help="Default branch.")
+@click.option("--display-name", help="Display name.")
+@click.option("--description", help="Project description.")
+@click.pass_context
+def projects_create(ctx, name, repo, branch, display_name, description):
+    """Create a new project."""
+    data = api.create_project(
+        name=name,
+        repo_url=repo,
+        branch=branch,
+        display_name=display_name,
+        description=description,
+    )
+    if ctx.obj["json"]:
+        print_json(data)
+        return
+    click.secho(f"Project '{data['name']}' created.", fg="green")
+    print_kv([
+        ("ID:", data["id"]),
+        ("Domain:", data.get("domain", "-")),
+    ])
+
+
+@projects.command("show")
+@click.argument("project")
+@click.pass_context
+def projects_show(ctx, project):
+    """Show project details. Accepts a project name or UUID."""
+    project_id = api.resolve_project_id(project)
+    data = api.get_project(project_id)
+    if ctx.obj["json"]:
+        print_json(data)
+        return
+    print_kv([
+        ("ID:", data["id"]),
+        ("Name:", data.get("name", "-")),
+        ("Display Name:", data.get("display_name") or "-"),
+        ("Repo:", data.get("repo_url", "-")),
+        ("Branch:", data.get("repo_branch", "-")),
+        ("Framework:", data.get("framework") or "-"),
+        ("Dockerfile:", str(data.get("has_dockerfile", "-"))),
+        ("Status:", data.get("status", "-")),
+        ("Domain:", data.get("domain") or "-"),
+        ("Created:", format_dt(data.get("created_at"))),
+    ])
+
+
+@projects.command("delete")
+@click.argument("project")
+@click.confirmation_option(prompt="Are you sure you want to delete this project?")
+def projects_delete(project):
+    """Delete a project and its infrastructure. Accepts a project name or UUID."""
+    project_id = api.resolve_project_id(project)
+    api.delete_project(project_id)
+    click.secho("Project deleted.", fg="green")
+
+
+@projects.command("analyze")
+@click.argument("project")
+@click.pass_context
+def projects_analyze(ctx, project):
+    """Analyze a project's repository. Accepts a project name or UUID."""
+    project_id = api.resolve_project_id(project)
+    data = api.analyze_project(project_id)
+    if ctx.obj["json"]:
+        print_json(data)
+        return
+    print_kv([
+        ("Framework:", data.get("framework", "-")),
+        ("Has Dockerfile:", str(data.get("has_dockerfile", "-"))),
+        ("Detected Port:", str(data.get("detected_port", "-"))),
+        ("Suggested CPU:", str(data.get("suggested_cpu", "-"))),
+        ("Suggested Memory:", data.get("suggested_memory", "-")),
+    ])
+
+
+@projects.command("update")
+@click.argument("project")
+@click.option("--display-name", help="New display name.")
+@click.option("--description", help="New description.")
+@click.option("--branch", help="New default branch.")
+@click.pass_context
+def projects_update(ctx, project, display_name, description, branch):
+    """Update project settings. Accepts a project name or UUID."""
+    project_id = api.resolve_project_id(project)
+    fields = {}
+    if display_name is not None:
+        fields["display_name"] = display_name
+    if description is not None:
+        fields["description"] = description
+    if branch is not None:
+        fields["repo_branch"] = branch
+    if not fields:
+        click.secho("No fields to update.", fg="yellow")
+        return
+    data = api.update_project(project_id, **fields)
+    if ctx.obj["json"]:
+        print_json(data)
+        return
+    click.secho(f"Project '{data['name']}' updated.", fg="green")
+
+
+# ---------------------------------------------------------------------------
+# Environments
+# ---------------------------------------------------------------------------
+
+@cli.group("envs")
+def envs():
+    """Manage environments."""
+
+
+@envs.command("list")
+@click.argument("project")
+@click.pass_context
+def envs_list(ctx, project):
+    """List environments for a project."""
+    project_id = api.resolve_project_id(project)
+    data = api.list_environments(project_id)
+    if ctx.obj["json"]:
+        print_json(data)
+        return
+
+    rows = []
+    for e in data:
+        rows.append([
+            e.get("name", "-"),
+            e.get("branch", "-"),
+            e.get("domain") or "-",
+            "Yes" if e.get("is_production") else "No",
+            "Yes" if e.get("auto_deploy") else "No",
+            status_color(e.get("status", "-")),
+        ])
+    print_table("Environments", ["Name", "Branch", "Domain", "Prod", "Auto Deploy", "Status"], rows)
+
+
+@envs.command("create")
+@click.argument("project")
+@click.argument("name")
+@click.option("--branch", required=True, help="Git branch.")
+@click.option("--auto-deploy/--no-auto-deploy", default=True, help="Auto deploy on push.")
+@click.pass_context
+def envs_create(ctx, project, name, branch, auto_deploy):
+    """Create a new environment."""
+    project_id = api.resolve_project_id(project)
+    data = api.create_environment(project_id, name, branch, auto_deploy=auto_deploy)
+    if ctx.obj["json"]:
+        print_json(data)
+        return
+    click.secho(f"Environment '{data['name']}' created.", fg="green")
+    print_kv([
+        ("ID:", data["id"]),
+        ("Domain:", data.get("domain", "-")),
+    ])
+
+
+@envs.command("update")
+@click.argument("project")
+@click.argument("env_id")
+@click.option("--branch", help="New branch.")
+@click.option("--auto-deploy/--no-auto-deploy", default=None, help="Auto deploy on push.")
+@click.pass_context
+def envs_update(ctx, project, env_id, branch, auto_deploy):
+    """Update an environment."""
+    project_id = api.resolve_project_id(project)
+    fields = {}
+    if branch is not None:
+        fields["branch"] = branch
+    if auto_deploy is not None:
+        fields["auto_deploy"] = auto_deploy
+    if not fields:
+        click.secho("No fields to update.", fg="yellow")
+        return
+    data = api.update_environment(project_id, env_id, **fields)
+    if ctx.obj["json"]:
+        print_json(data)
+        return
+    click.secho(f"Environment '{data['name']}' updated.", fg="green")
+
+
+@envs.command("delete")
+@click.argument("project")
+@click.argument("env_id")
+@click.confirmation_option(prompt="Are you sure you want to delete this environment?")
+def envs_delete(project, env_id):
+    """Delete an environment."""
+    project_id = api.resolve_project_id(project)
+    api.delete_environment(project_id, env_id)
+    click.secho("Environment deleted.", fg="green")
+
+
+# ---------------------------------------------------------------------------
+# Deploy (shortcut)
+# ---------------------------------------------------------------------------
+
+@cli.command()
+@click.argument("project")
+@click.option("--env", "environment_id", help="Environment ID (defaults to production).")
+@click.pass_context
+def deploy(ctx, project, environment_id):
+    """Trigger a deployment."""
+    project_id = api.resolve_project_id(project)
+    data = api.trigger_deployment(project_id, environment_id)
+    if ctx.obj["json"]:
+        print_json(data)
+        return
+    click.secho("Deployment triggered.", fg="green")
+    print_kv([
+        ("Deployment ID:", data["id"]),
+        ("Status:", data.get("status", "-")),
+    ])
+    click.echo(f"\nTrack progress: orkestr deployments show {data['id']}")
+
+
+# ---------------------------------------------------------------------------
+# Deployments
+# ---------------------------------------------------------------------------
+
+@cli.group()
+def deployments():
+    """Manage deployments."""
+
+
+@deployments.command("list")
+@click.argument("project")
+@click.option("--limit", default=20, help="Max results.")
+@click.pass_context
+def deployments_list(ctx, project, limit):
+    """List deployments for a project."""
+    project_id = api.resolve_project_id(project)
+    data = api.list_deployments(project_id, limit=limit)
+    if ctx.obj["json"]:
+        print_json(data)
+        return
+
+    rows = []
+    for d in data.get("deployments", []):
+        rows.append([
+            d["id"][:8],
+            status_color(d.get("status", "-")),
+            d.get("trigger", "-"),
+            truncate(d.get("commit_sha") or "-", 8),
+            format_dt(d.get("created_at")),
+        ])
+    print_table("Deployments", ["ID", "Status", "Trigger", "Commit", "Created"], rows)
+    click.echo(f"\nTotal: {data.get('total', len(rows))}")
+
+
+@deployments.command("show")
+@click.argument("deployment_id")
+@click.pass_context
+def deployments_show(ctx, deployment_id):
+    """Show deployment details."""
+    data = api.get_deployment(deployment_id)
+    if ctx.obj["json"]:
+        print_json(data)
+        return
+    print_kv([
+        ("ID:", data["id"]),
+        ("Status:", data.get("status", "-")),
+        ("Trigger:", data.get("trigger", "-")),
+        ("Commit:", data.get("commit_sha") or "-"),
+        ("Image:", data.get("docker_image") or "-"),
+        ("Created:", format_dt(data.get("created_at"))),
+        ("Finished:", format_dt(data.get("finished_at"))),
+    ])
+
+    steps = data.get("steps", [])
+    if steps:
+        click.echo("\nPipeline Steps:")
+        for s in steps:
+            icon = {"completed": "[green]OK[/]", "failed": "[red]FAIL[/]", "running": "[yellow]...[/]"}.get(s.get("status"), "  ")
+            console.print(f"  {icon}  {s.get('step_name', '-')}")
+
+
+@deployments.command("logs")
+@click.argument("deployment_id")
+@click.pass_context
+def deployments_logs(ctx, deployment_id):
+    """Show deployment pipeline logs."""
+    data = api.get_deployment_logs(deployment_id)
+    if ctx.obj["json"]:
+        print_json(data)
+        return
+
+    current_step = None
+    for entry in data.get("logs", []):
+        step = entry.get("step", "")
+        if step != current_step:
+            current_step = step
+            click.secho(f"\n--- {step} ---", fg="cyan", bold=True)
+        click.echo(entry.get("message", ""))
+
+
+@deployments.command("rollback")
+@click.argument("deployment_id")
+@click.confirmation_option(prompt="Are you sure you want to rollback to this deployment?")
+@click.pass_context
+def deployments_rollback(ctx, deployment_id):
+    """Rollback to a previous deployment's image."""
+    data = api.rollback_deployment(deployment_id)
+    if ctx.obj["json"]:
+        print_json(data)
+        return
+    click.secho("Rollback deployment triggered.", fg="green")
+    print_kv([
+        ("Deployment ID:", data["id"]),
+        ("Status:", data.get("status", "-")),
+    ])
+
+
+# ---------------------------------------------------------------------------
+# Monitoring shortcuts
+# ---------------------------------------------------------------------------
+
+@cli.command()
+@click.argument("project")
+@click.option("--env", "environment_id", help="Environment ID.")
+@click.option("--lines", default=200, help="Number of log lines.")
+@click.pass_context
+def logs(ctx, project, environment_id, lines):
+    """Show application runtime logs."""
+    project_id = api.resolve_project_id(project)
+    data = api.get_logs(project_id, environment_id, lines)
+    if ctx.obj["json"]:
+        print_json(data)
+        return
+
+    click.secho(f"Container: {data.get('container', '-')}", fg="cyan")
+    click.echo()
+    for line in data.get("logs", "").strip().split("\n"):
+        click.echo(line)
+
+
+@cli.command()
+@click.argument("project")
+@click.option("--env", "environment_id", help="Environment ID.")
+@click.pass_context
+def stats(ctx, project, environment_id):
+    """Show container resource stats."""
+    project_id = api.resolve_project_id(project)
+    data = api.get_stats(project_id, environment_id)
+    if ctx.obj["json"]:
+        print_json(data)
+        return
+
+    print_kv([
+        ("CPU %:", str(data.get("cpu_percent", "-"))),
+        ("Memory:", f"{data.get('memory_usage', '-')} / {data.get('memory_limit', '-')}"),
+        ("Memory %:", str(data.get("memory_percent", "-"))),
+        ("Net I/O:", f"{data.get('network_rx', '-')} / {data.get('network_tx', '-')}"),
+    ])
+
+
+@cli.command()
+@click.argument("project")
+@click.option("--env", "environment_id", help="Environment ID.")
+@click.pass_context
+def health(ctx, project, environment_id):
+    """Show container health info."""
+    project_id = api.resolve_project_id(project)
+    data = api.get_health(project_id, environment_id)
+    if ctx.obj["json"]:
+        print_json(data)
+        return
+
+    print_kv([
+        ("Status:", data.get("status", "-")),
+        ("Uptime:", data.get("uptime", "-")),
+        ("Restarts:", str(data.get("restart_count", "-"))),
+        ("Image:", data.get("image", "-")),
+        ("Started:", data.get("started_at", "-")),
+    ])
+
+
+# ---------------------------------------------------------------------------
+# Entry point
+# ---------------------------------------------------------------------------
+
+if __name__ == "__main__":
+    cli()

orkestr_cli/output.py

@@ -0,0 +1,59 @@
+"""Output formatting helpers using Rich."""
+
+import json as json_mod
+
+import click
+from rich.console import Console
+from rich.table import Table
+
+console = Console()
+
+
+def print_json(data):
+    """Print raw JSON output."""
+    click.echo(json_mod.dumps(data, indent=2, default=str))
+
+
+def print_table(title: str, columns: list[str], rows: list[list[str]]):
+    """Print a Rich table."""
+    table = Table(title=title, show_lines=False)
+    for col in columns:
+        table.add_column(col)
+    for row in rows:
+        table.add_row(*[str(c) for c in row])
+    console.print(table)
+
+
+def print_kv(pairs: list[tuple[str, str]]):
+    """Print key-value pairs."""
+    max_key = max(len(k) for k, _ in pairs) if pairs else 0
+    for key, value in pairs:
+        click.echo(f"  {key:<{max_key + 2}} {value}")
+
+
+def truncate(text: str, length: int = 40) -> str:
+    if not text:
+        return "-"
+    return text[:length] + "..." if len(text) > length else text
+
+
+def format_dt(dt_str: str | None) -> str:
+    if not dt_str:
+        return "-"
+    return dt_str[:19].replace("T", " ")
+
+
+def status_color(status: str) -> str:
+    colors = {
+        "live": "green",
+        "running": "green",
+        "active": "green",
+        "building": "yellow",
+        "deploying": "yellow",
+        "queued": "cyan",
+        "failed": "red",
+        "deleted": "dim",
+        "stopped": "dim",
+    }
+    color = colors.get(status, "white")
+    return click.style(status, fg=color)

orkestr_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: orkestr-cli
+Version: 0.1.0
+Summary: CLI for the Orkestr Internal Developer Platform
+Author-email: Orkestr <hello@orkestr.eu>
+License-Expression: MIT
+Project-URL: Homepage, https://orkestr.eu
+Project-URL: Documentation, https://orkestr.eu/docs
+Project-URL: Repository, https://github.com/orkestr/cli
+Keywords: orkestr,cli,deploy,paas,idp
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.1
+Requires-Dist: httpx>=0.27
+Requires-Dist: rich>=13.0
+
+# orkestr-cli
+
+CLI for the [Orkestr](https://orkestr.eu) Internal Developer Platform.
+
+## Install
+
+```bash
+pip install orkestr-cli
+```
+
+## Quick start
+
+```bash
+# Authenticate with your API token
+orkestr login
+
+# List your projects
+orkestr projects list
+
+# Deploy
+orkestr deploy my-api
+
+# View logs
+orkestr logs my-api
+
+# Check health
+orkestr health my-api
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `orkestr login` | Authenticate with an API token |
+| `orkestr logout` | Clear stored credentials |
+| `orkestr whoami` | Show current user info |
+| `orkestr projects list\|create\|show\|update\|delete\|analyze` | Manage projects |
+| `orkestr envs list\|create\|update\|delete` | Manage environments |
+| `orkestr deploy <project>` | Trigger a deployment |
+| `orkestr deployments list\|show\|logs\|rollback` | Deployment history |
+| `orkestr logs <project>` | Runtime container logs |
+| `orkestr stats <project>` | CPU/memory/network stats |
+| `orkestr health <project>` | Container health info |
+
+All commands support `--json` for raw JSON output.
+
+## Documentation
+
+Full docs at [orkestr.eu/docs](https://orkestr.eu/docs)

orkestr_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+orkestr_cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orkestr_cli/api.py,sha256=sDcDRc1kWDcI6sNpZJUGxhBkvhti0ByNULzD-OYAkb4,6261
+orkestr_cli/config.py,sha256=iC5sXHklxQ0QkaKSpZIk_AMQyTizRqNIznbsqmcL0LQ,1943
+orkestr_cli/main.py,sha256=ugHYdD50LRfQMdU183sLOw7ImXa0uyRpOt6d6a1juqA,16476
+orkestr_cli/output.py,sha256=KdP31LYFzyYDbOY25Ctq6Qg7jga5WtgPAHEOKDV_IIU,1466
+orkestr_cli-0.1.0.dist-info/METADATA,sha256=9kFsFH6LWy0lFg2EUCMkm1dJe91m2Xzm1eDGDrEGyqk,2073
+orkestr_cli-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+orkestr_cli-0.1.0.dist-info/entry_points.txt,sha256=5SHqNcPp8OmqT6fzC2A8N5H8jp8PNrRaTE4UtvMyD1g,49
+orkestr_cli-0.1.0.dist-info/top_level.txt,sha256=xTY9D1RhX1fP7vxK4RlK8owWvjijvZZNXNBoSfyH7LE,12
+orkestr_cli-0.1.0.dist-info/RECORD,,

orkestr_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

orkestr_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+orkestr = orkestr_cli.main:cli

orkestr_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+orkestr_cli