pmctl 0.1.0__tar.gz

pmctl-0.1.0/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(python:*)",
+      "Bash(pmctl completion:*)"
+    ]
+  }
+}

pmctl-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+.env
+.ruff_cache/
+.mypy_cache/

pmctl-0.1.0/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: pmctl
+Version: 0.1.0
+Summary: A CLI tool for managing Postman collections, environments, and workspaces
+Project-URL: Homepage, https://github.com/wbinglee/pmctl
+Project-URL: Repository, https://github.com/wbinglee/pmctl
+Project-URL: Issues, https://github.com/wbinglee/pmctl/issues
+Author: Wenbing Li
+License-Expression: MIT
+Keywords: api,cli,collections,postman
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Description-Content-Type: text/markdown
+
+# pmctl
+
+A CLI tool for managing Postman collections, environments, and workspaces.
+
+The official Postman CLI only supports running collections. `pmctl` fills the gap by wrapping the [Postman API](https://www.postman.com/postman/postman-public-workspace/documentation/12946884/postman-api) to let you browse and manage your Postman resources from the terminal.
+
+## Features
+
+- 🔑 **Multi-profile support** — manage multiple Postman accounts (personal, work, etc.)
+- 📦 **Browse collections** — list and inspect collections with a beautiful tree view
+- 🌍 **Environments** — list environments and view variables
+- 🏢 **Workspaces** — list all accessible workspaces
+- 🎨 **Rich output** — colored tables and trees powered by [Rich](https://github.com/Textualize/rich)
+
+## Installation
+
+```bash
+pip install pmctl
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/wbinglee/pmctl.git
+cd pmctl
+pip install -e .
+```
+
+## Quick Start
+
+### 1. Add a profile
+
+```bash
+# Add your Postman API key (get one at https://go.postman.co/settings/me/api-keys)
+pmctl profile add personal --api-key "PMAK-..." --label "Personal Account" --default
+
+# Add another profile (e.g., work account)
+pmctl profile add work --api-key "PMAK-..." --label "Work Account"
+```
+
+### 2. Browse your resources
+
+```bash
+# List collections
+pmctl collections list
+
+# List collections in a specific workspace
+pmctl collections list --workspace <workspace-id>
+
+# Show all requests in a collection (tree view)
+pmctl collections show <collection-uid>
+
+# List environments
+pmctl environments list
+
+# Show environment variables
+pmctl environments show <env-id> --values
+
+# List workspaces
+pmctl workspaces list
+```
+
+### 3. Switch between profiles
+
+```bash
+# Switch default profile
+pmctl profile switch work
+
+# Or use --profile flag on any command
+pmctl collections list --profile personal
+
+# Check who you're logged in as
+pmctl profile whoami
+```
+
+## Profile Management
+
+```bash
+pmctl profile list          # List all profiles
+pmctl profile add <name>    # Add a new profile
+pmctl profile remove <name> # Remove a profile
+pmctl profile switch <name> # Set default profile
+pmctl profile whoami        # Show current user info
+```
+
+## Configuration
+
+Profiles are stored in `~/.config/pmctl/config.toml`:
+
+```toml
+[profiles.personal]
+api_key = "PMAK-..."
+label = "personal@example.com"
+
+[profiles.work]
+api_key = "PMAK-..."
+label = "work@company.com"
+
+default_profile = "work"
+```
+
+## Getting a Postman API Key
+
+1. Go to [Postman API Keys](https://go.postman.co/settings/me/api-keys)
+2. Click **Generate API Key**
+3. Copy the key and add it with `pmctl profile add`
+
+> **Note:** If you have multiple Postman accounts (e.g., personal + company SSO), each account has its own API keys page. Log into the correct account first.
+
+## License
+
+MIT

pmctl-0.1.0/README.md

@@ -0,0 +1,112 @@
+# pmctl
+
+A CLI tool for managing Postman collections, environments, and workspaces.
+
+The official Postman CLI only supports running collections. `pmctl` fills the gap by wrapping the [Postman API](https://www.postman.com/postman/postman-public-workspace/documentation/12946884/postman-api) to let you browse and manage your Postman resources from the terminal.
+
+## Features
+
+- 🔑 **Multi-profile support** — manage multiple Postman accounts (personal, work, etc.)
+- 📦 **Browse collections** — list and inspect collections with a beautiful tree view
+- 🌍 **Environments** — list environments and view variables
+- 🏢 **Workspaces** — list all accessible workspaces
+- 🎨 **Rich output** — colored tables and trees powered by [Rich](https://github.com/Textualize/rich)
+
+## Installation
+
+```bash
+pip install pmctl
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/wbinglee/pmctl.git
+cd pmctl
+pip install -e .
+```
+
+## Quick Start
+
+### 1. Add a profile
+
+```bash
+# Add your Postman API key (get one at https://go.postman.co/settings/me/api-keys)
+pmctl profile add personal --api-key "PMAK-..." --label "Personal Account" --default
+
+# Add another profile (e.g., work account)
+pmctl profile add work --api-key "PMAK-..." --label "Work Account"
+```
+
+### 2. Browse your resources
+
+```bash
+# List collections
+pmctl collections list
+
+# List collections in a specific workspace
+pmctl collections list --workspace <workspace-id>
+
+# Show all requests in a collection (tree view)
+pmctl collections show <collection-uid>
+
+# List environments
+pmctl environments list
+
+# Show environment variables
+pmctl environments show <env-id> --values
+
+# List workspaces
+pmctl workspaces list
+```
+
+### 3. Switch between profiles
+
+```bash
+# Switch default profile
+pmctl profile switch work
+
+# Or use --profile flag on any command
+pmctl collections list --profile personal
+
+# Check who you're logged in as
+pmctl profile whoami
+```
+
+## Profile Management
+
+```bash
+pmctl profile list          # List all profiles
+pmctl profile add <name>    # Add a new profile
+pmctl profile remove <name> # Remove a profile
+pmctl profile switch <name> # Set default profile
+pmctl profile whoami        # Show current user info
+```
+
+## Configuration
+
+Profiles are stored in `~/.config/pmctl/config.toml`:
+
+```toml
+[profiles.personal]
+api_key = "PMAK-..."
+label = "personal@example.com"
+
+[profiles.work]
+api_key = "PMAK-..."
+label = "work@company.com"
+
+default_profile = "work"
+```
+
+## Getting a Postman API Key
+
+1. Go to [Postman API Keys](https://go.postman.co/settings/me/api-keys)
+2. Click **Generate API Key**
+3. Copy the key and add it with `pmctl profile add`
+
+> **Note:** If you have multiple Postman accounts (e.g., personal + company SSO), each account has its own API keys page. Log into the correct account first.
+
+## License
+
+MIT

pmctl-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pmctl"
+version = "0.1.0"
+description = "A CLI tool for managing Postman collections, environments, and workspaces"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+authors = [
+    { name = "Wenbing Li" },
+]
+keywords = ["postman", "cli", "api", "collections"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Testing",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "typer>=0.9.0",
+    "httpx>=0.25.0",
+    "rich>=13.0.0",
+]
+
+[project.scripts]
+pmctl = "pmctl.cli:app"
+
+[project.urls]
+Homepage = "https://github.com/wbinglee/pmctl"
+Repository = "https://github.com/wbinglee/pmctl"
+Issues = "https://github.com/wbinglee/pmctl/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pmctl"]
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100

pmctl-0.1.0/src/pmctl/__init__.py

@@ -0,0 +1,3 @@
+"""pmctl - A CLI tool for managing Postman resources."""
+
+__version__ = "0.1.0"

pmctl-0.1.0/src/pmctl/api.py

@@ -0,0 +1,74 @@
+"""Postman API client."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+import httpx
+
+BASE_URL = "https://api.getpostman.com"
+
+
+class PostmanClient:
+    """HTTP client for the Postman API."""
+
+    def __init__(self, api_key: str):
+        self.api_key = api_key
+        self._client = httpx.Client(
+            base_url=BASE_URL,
+            headers={"X-Api-Key": api_key},
+            timeout=30.0,
+        )
+
+    def _get(self, path: str, params: Optional[dict] = None) -> dict[str, Any]:
+        """Make a GET request to the Postman API."""
+        response = self._client.get(path, params=params)
+        response.raise_for_status()
+        return response.json()
+
+    def close(self) -> None:
+        self._client.close()
+
+    def __enter__(self) -> "PostmanClient":
+        return self
+
+    def __exit__(self, *args: Any) -> None:
+        self.close()
+
+    # --- User ---
+
+    def get_me(self) -> dict[str, Any]:
+        """Get current user info."""
+        return self._get("/me")
+
+    # --- Workspaces ---
+
+    def list_workspaces(self) -> list[dict[str, Any]]:
+        """List all accessible workspaces."""
+        return self._get("/workspaces").get("workspaces", [])
+
+    def get_workspace(self, workspace_id: str) -> dict[str, Any]:
+        """Get workspace details."""
+        return self._get(f"/workspaces/{workspace_id}").get("workspace", {})
+
+    # --- Collections ---
+
+    def list_collections(self, workspace_id: Optional[str] = None) -> list[dict[str, Any]]:
+        """List collections, optionally filtered by workspace."""
+        params = {"workspace": workspace_id} if workspace_id else None
+        return self._get("/collections", params=params).get("collections", [])
+
+    def get_collection(self, collection_uid: str) -> dict[str, Any]:
+        """Get full collection details including all requests."""
+        return self._get(f"/collections/{collection_uid}").get("collection", {})
+
+    # --- Environments ---
+
+    def list_environments(self, workspace_id: Optional[str] = None) -> list[dict[str, Any]]:
+        """List environments, optionally filtered by workspace."""
+        params = {"workspace": workspace_id} if workspace_id else None
+        return self._get("/environments", params=params).get("environments", [])
+
+    def get_environment(self, environment_id: str) -> dict[str, Any]:
+        """Get environment details including variables."""
+        return self._get(f"/environments/{environment_id}").get("environment", {})

pmctl-0.1.0/src/pmctl/cli.py

@@ -0,0 +1,441 @@
+"""pmctl - CLI entry point."""
+
+from __future__ import annotations
+
+from typing import Optional
+
+import typer
+from rich.console import Console
+from rich.table import Table
+from rich.tree import Tree
+
+from pmctl.api import PostmanClient
+from pmctl.config import (
+    add_profile,
+    load_config,
+    remove_profile,
+    set_default_profile,
+    set_profile_workspace,
+)
+
+app = typer.Typer(
+    name="pmctl",
+    help="A CLI tool for managing Postman collections, environments, and workspaces.",
+    no_args_is_help=True,
+)
+console = Console()
+
+# --- Profile subcommand ---
+
+profile_app = typer.Typer(help="Manage Postman API key profiles.", no_args_is_help=True)
+app.add_typer(profile_app, name="profile")
+
+
+@profile_app.command("list")
+def profile_list():
+    """List all configured profiles."""
+    config = load_config()
+    table = Table(title="Profiles")
+    table.add_column("Name", style="cyan")
+    table.add_column("Label", style="dim")
+    table.add_column("Default", style="green")
+    table.add_column("Workspace", style="dim")
+    table.add_column("API Key", style="dim")
+
+    for prof_name, profile in config.profiles.items():
+        is_default = "✓" if prof_name == config.default_profile else ""
+        masked_key = profile.api_key[:12] + "..." + profile.api_key[-4:]
+        ws = profile.workspace[:12] + "..." if len(profile.workspace) > 12 else profile.workspace
+        table.add_row(prof_name, profile.label, is_default, ws, masked_key)
+
+    console.print(table)
+
+
+@profile_app.command("add")
+def profile_add(
+    name: str = typer.Argument(help="Profile name"),
+    api_key: str = typer.Option(..., "--api-key", "-k", help="Postman API key"),
+    label: str = typer.Option("", "--label", "-l", help="Description label"),
+    default: bool = typer.Option(False, "--default", "-d", help="Set as default profile"),
+):
+    """Add a new profile."""
+    config = add_profile(name, api_key, label, set_default=default)
+    console.print(f"[green]✓[/] Profile '{name}' added.")
+    if name == config.default_profile:
+        console.print(f"[green]✓[/] Set as default profile.")
+
+
+@profile_app.command("remove")
+def profile_remove(name: str = typer.Argument(help="Profile name to remove")):
+    """Remove a profile."""
+    remove_profile(name)
+    console.print(f"[green]✓[/] Profile '{name}' removed.")
+
+
+@profile_app.command("switch")
+def profile_switch(name: str = typer.Argument(help="Profile name to set as default")):
+    """Switch the default profile."""
+    set_default_profile(name)
+    console.print(f"[green]✓[/] Default profile switched to '{name}'.")
+
+
+@profile_app.command("set-workspace")
+def profile_set_workspace(
+    workspace_id: str = typer.Argument(help="Default workspace ID for this profile"),
+    profile: Optional[str] = typer.Option(None, "--profile", "-p", help="Profile to update (default: current default)"),
+):
+    """Set the default workspace for a profile."""
+    config = set_profile_workspace(profile or "", workspace_id)
+    name = profile or config.default_profile
+    console.print(f"[green]✓[/] Default workspace for '{name}' set to '{workspace_id}'.")
+
+
+@profile_app.command("whoami")
+def profile_whoami(
+    profile: Optional[str] = typer.Option(None, "--profile", "-p", help="Profile to use"),
+):
+    """Show current user info for the active profile."""
+    config = load_config()
+    p = config.get_profile(profile)
+    with PostmanClient(p.api_key) as client:
+        user = client.get_me().get("user", {})
+    console.print(f"[cyan]Email:[/]  {user.get('email', 'N/A')}")
+    console.print(f"[cyan]Name:[/]   {user.get('fullName', 'N/A')}")
+    console.print(f"[cyan]Team:[/]   {user.get('teamName', 'N/A')}")
+    console.print(f"[cyan]Domain:[/] {user.get('teamDomain', 'N/A')}")
+
+
+# --- Workspaces subcommand ---
+
+workspace_app = typer.Typer(help="Manage Postman workspaces.", no_args_is_help=True)
+app.add_typer(workspace_app, name="workspaces")
+
+
+@workspace_app.command("list")
+def workspaces_list(
+    search: Optional[str] = typer.Option(None, "--search", "-s", help="Filter workspaces by name (case-insensitive)"),
+    profile: Optional[str] = typer.Option(None, "--profile", "-p", help="Profile to use"),
+):
+    """List all accessible workspaces."""
+    config = load_config()
+    p = config.get_profile(profile)
+    with PostmanClient(p.api_key) as client:
+        workspaces = client.list_workspaces()
+
+    if search:
+        keyword = search.lower()
+        workspaces = [ws for ws in workspaces if keyword in ws["name"].lower()]
+
+    table = Table(title=f"Workspaces ({p.label or p.name})")
+    table.add_column("Name", style="cyan")
+    table.add_column("ID", style="dim")
+    table.add_column("Type", style="green")
+
+    for ws in sorted(workspaces, key=lambda w: w["name"].lower()):
+        table.add_row(ws["name"], ws["id"], ws.get("type", ""))
+
+    console.print(table)
+    console.print(f"\n[dim]Total: {len(workspaces)} workspaces[/]")
+
+
+# --- Collections subcommand ---
+
+collection_app = typer.Typer(help="Manage Postman collections.", no_args_is_help=True)
+app.add_typer(collection_app, name="collections")
+
+
+@collection_app.command("list")
+def collections_list(
+    workspace: Optional[str] = typer.Option(None, "--workspace", "-w", help="Filter by workspace ID"),
+    all_workspaces: bool = typer.Option(False, "--all", "-a", help="Show collections from all workspaces"),
+    profile: Optional[str] = typer.Option(None, "--profile", "-p", help="Profile to use"),
+):
+    """List collections."""
+    config = load_config()
+    p = config.get_profile(profile)
+    effective_workspace = workspace or (None if all_workspaces else p.workspace or None)
+    with PostmanClient(p.api_key) as client:
+        collections = client.list_collections(workspace_id=effective_workspace)
+
+    table = Table(title=f"Collections ({p.label or p.name})")
+    table.add_column("Name", style="cyan")
+    table.add_column("UID", style="dim")
+    table.add_column("Updated", style="dim")
+
+    for col in sorted(collections, key=lambda c: c["name"].lower()):
+        updated = col.get("updatedAt", "")[:10]
+        table.add_row(col["name"], col["uid"], updated)
+
+    console.print(table)
+    console.print(f"\n[dim]Total: {len(collections)} collections[/]")
+
+
+@collection_app.command("show")
+def collections_show(
+    uid: str = typer.Argument(help="Collection UID"),
+    profile: Optional[str] = typer.Option(None, "--profile", "-p", help="Profile to use"),
+):
+    """Show all requests in a collection as a tree."""
+    config = load_config()
+    p = config.get_profile(profile)
+    with PostmanClient(p.api_key) as client:
+        collection = client.get_collection(uid)
+
+    tree = Tree(f"[bold cyan]{collection.get('info', {}).get('name', 'Collection')}[/]")
+    _build_tree(tree, collection.get("item", []))
+    console.print(tree)
+
+
+def _build_tree(tree: Tree, items: list) -> None:
+    """Recursively build a Rich tree from collection items."""
+    for item in items:
+        if "item" in item:
+            # It's a folder
+            branch = tree.add(f"📁 [bold]{item['name']}[/]")
+            _build_tree(branch, item["item"])
+        else:
+            # It's a request
+            req = item.get("request", {})
+            method = req.get("method", "?")
+            url = req.get("url", {})
+            raw_url = url.get("raw", url) if isinstance(url, dict) else url
+
+            method_colors = {
+                "GET": "green",
+                "POST": "yellow",
+                "PUT": "blue",
+                "PATCH": "magenta",
+                "DELETE": "red",
+            }
+            color = method_colors.get(method, "white")
+            tree.add(f"[bold {color}]{method:7s}[/] {item['name']}  [dim]{raw_url}[/]")
+
+
+@collection_app.command("request")
+def collections_request(
+    uid: str = typer.Argument(help="Collection UID"),
+    name: str = typer.Argument(help="Request name (case-insensitive substring match)"),
+    profile: Optional[str] = typer.Option(None, "--profile", "-p", help="Profile to use"),
+):
+    """Show details of a specific request in a collection."""
+    config = load_config()
+    p = config.get_profile(profile)
+    with PostmanClient(p.api_key) as client:
+        collection = client.get_collection(uid)
+
+    matches = _find_requests(collection.get("item", []), name)
+    if not matches:
+        console.print(f"[red]No request matching '{name}' found.[/]")
+        raise typer.Exit(1)
+    if len(matches) > 1:
+        console.print(f"[yellow]Multiple matches found ({len(matches)}). Showing first match.[/]")
+        for i, (path, _) in enumerate(matches):
+            console.print(f"  [dim]{i + 1}. {path}[/]")
+        console.print()
+
+    path, item = matches[0]
+    req = item.get("request", {})
+    method = req.get("method", "?")
+    url = req.get("url", {})
+    raw_url = url.get("raw", url) if isinstance(url, dict) else url
+
+    method_colors = {
+        "GET": "green", "POST": "yellow", "PUT": "blue",
+        "PATCH": "magenta", "DELETE": "red",
+    }
+    color = method_colors.get(method, "white")
+
+    console.print(f"[bold]{path}[/]\n")
+    console.print(f"[bold {color}]{method}[/] {raw_url}\n")
+
+    # Auth
+    auth = req.get("auth")
+    if auth:
+        auth_type = auth.get("type", "unknown")
+        console.print(f"[cyan]Auth:[/] {auth_type}")
+
+    # Headers
+    headers = req.get("header", [])
+    if headers:
+        table = Table(title="Headers", show_edge=False)
+        table.add_column("Key", style="cyan")
+        table.add_column("Value")
+        table.add_column("Enabled", style="dim")
+        for h in headers:
+            enabled = "✗" if h.get("disabled") else "✓"
+            table.add_row(h.get("key", ""), h.get("value", ""), enabled)
+        console.print(table)
+
+    # Query params
+    if isinstance(url, dict):
+        query = url.get("query", [])
+        if query:
+            table = Table(title="Query Params", show_edge=False)
+            table.add_column("Key", style="cyan")
+            table.add_column("Value")
+            table.add_column("Enabled", style="dim")
+            for q in query:
+                enabled = "✗" if q.get("disabled") else "✓"
+                table.add_row(q.get("key", ""), q.get("value", ""), enabled)
+            console.print(table)
+
+        # Path variables
+        variables = url.get("variable", [])
+        if variables:
+            table = Table(title="Path Variables", show_edge=False)
+            table.add_column("Key", style="cyan")
+            table.add_column("Value")
+            for v in variables:
+                table.add_row(v.get("key", ""), v.get("value", ""))
+            console.print(table)
+
+    # Body
+    body = req.get("body")
+    if body:
+        mode = body.get("mode", "")
+        console.print(f"\n[cyan]Body[/] [dim]({mode})[/]")
+        if mode == "raw":
+            raw = body.get("raw", "")
+            if raw:
+                console.print(raw)
+        elif mode == "formdata":
+            table = Table(show_edge=False)
+            table.add_column("Key", style="cyan")
+            table.add_column("Value")
+            table.add_column("Type", style="dim")
+            for fd in body.get("formdata", []):
+                table.add_row(fd.get("key", ""), fd.get("value", ""), fd.get("type", "text"))
+            console.print(table)
+        elif mode == "urlencoded":
+            table = Table(show_edge=False)
+            table.add_column("Key", style="cyan")
+            table.add_column("Value")
+            for ue in body.get("urlencoded", []):
+                table.add_row(ue.get("key", ""), ue.get("value", ""))
+            console.print(table)
+
+
+def _find_requests(items: list, name: str, prefix: str = "") -> list[tuple[str, dict]]:
+    """Recursively find requests matching a name (case-insensitive substring)."""
+    matches = []
+    keyword = name.lower()
+    for item in items:
+        path = f"{prefix}/{item['name']}" if prefix else item["name"]
+        if "item" in item:
+            matches.extend(_find_requests(item["item"], name, path))
+        elif keyword in item["name"].lower():
+            matches.append((path, item))
+    return matches
+
+
+# --- Environments subcommand ---
+
+env_app = typer.Typer(help="Manage Postman environments.", no_args_is_help=True)
+app.add_typer(env_app, name="environments")
+
+
+@env_app.command("list")
+def environments_list(
+    workspace: Optional[str] = typer.Option(None, "--workspace", "-w", help="Filter by workspace ID"),
+    all_workspaces: bool = typer.Option(False, "--all", "-a", help="Show environments from all workspaces"),
+    profile: Optional[str] = typer.Option(None, "--profile", "-p", help="Profile to use"),
+):
+    """List environments."""
+    config = load_config()
+    p = config.get_profile(profile)
+    effective_workspace = workspace or (None if all_workspaces else p.workspace or None)
+    with PostmanClient(p.api_key) as client:
+        environments = client.list_environments(workspace_id=effective_workspace)
+
+    table = Table(title=f"Environments ({p.label or p.name})")
+    table.add_column("Name", style="cyan")
+    table.add_column("ID", style="dim")
+
+    for env in sorted(environments, key=lambda e: e["name"].lower()):
+        table.add_row(env["name"], env["id"])
+
+    console.print(table)
+    console.print(f"\n[dim]Total: {len(environments)} environments[/]")
+
+
+@env_app.command("show")
+def environments_show(
+    env_id: str = typer.Argument(help="Environment ID"),
+    show_values: bool = typer.Option(False, "--values", "-v", help="Show variable values"),
+    profile: Optional[str] = typer.Option(None, "--profile", "-p", help="Profile to use"),
+):
+    """Show environment variables."""
+    config = load_config()
+    p = config.get_profile(profile)
+    with PostmanClient(p.api_key) as client:
+        env = client.get_environment(env_id)
+
+    console.print(f"[bold cyan]{env.get('name', 'Environment')}[/]\n")
+
+    table = Table()
+    table.add_column("Variable", style="cyan")
+    table.add_column("Type", style="dim")
+    if show_values:
+        table.add_column("Value")
+
+    for var in env.get("values", []):
+        row = [var["key"], var.get("type", "default")]
+        if show_values:
+            value = var.get("value", "")
+            # Mask sensitive-looking values
+            if any(k in var["key"].lower() for k in ("password", "secret", "token", "key")):
+                value = value[:4] + "****" if len(value) > 4 else "****"
+            row.append(value)
+        table.add_row(*row)
+
+    console.print(table)
+
+
+# --- Completion subcommand ---
+
+completion_app = typer.Typer(help="Generate shell completion scripts.", no_args_is_help=True)
+app.add_typer(completion_app, name="completion")
+
+
+def _print_completion_script(shell: str) -> None:
+    """Generate and print a shell completion script."""
+    from click.shell_completion import get_completion_class
+
+    click_app = typer.main.get_command(app)
+    comp_cls = get_completion_class(shell)
+    if comp_cls is None:
+        console.print(f"[red]Error:[/] Unsupported shell '{shell}'.")
+        raise typer.Exit(1)
+    comp = comp_cls(click_app, {}, "pmctl", "_PMCTL_COMPLETE")
+    typer.echo(comp.source())
+
+
+@completion_app.command("bash")
+def completion_bash():
+    """Generate bash completion script.
+
+    Usage:  eval "$(pmctl completion bash)"
+    """
+    _print_completion_script("bash")
+
+
+@completion_app.command("zsh")
+def completion_zsh():
+    """Generate zsh completion script.
+
+    Usage:  eval "$(pmctl completion zsh)"
+    """
+    _print_completion_script("zsh")
+
+
+@completion_app.command("fish")
+def completion_fish():
+    """Generate fish completion script.
+
+    Usage:  pmctl completion fish > ~/.config/fish/completions/pmctl.fish
+    """
+    _print_completion_script("fish")
+
+
+if __name__ == "__main__":
+    app()

pmctl-0.1.0/src/pmctl/config.py

@@ -0,0 +1,154 @@
+"""Configuration management for pmctl.
+
+Manages multiple Postman API key profiles stored in ~/.config/pmctl/config.toml.
+"""
+
+from __future__ import annotations
+
+import tomllib
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Optional
+
+CONFIG_DIR = Path.home() / ".config" / "pmctl"
+CONFIG_FILE = CONFIG_DIR / "config.toml"
+
+
+@dataclass
+class Profile:
+    """A Postman API key profile."""
+
+    name: str
+    api_key: str
+    label: str = ""
+    workspace: str = ""
+
+
+@dataclass
+class Config:
+    """Application configuration."""
+
+    profiles: dict[str, Profile]
+    default_profile: str
+
+    def get_profile(self, name: Optional[str] = None) -> Profile:
+        """Get a profile by name, or the default profile."""
+        profile_name = name or self.default_profile
+        if profile_name not in self.profiles:
+            available = ", ".join(self.profiles.keys())
+            raise ValueError(
+                f"Profile '{profile_name}' not found. Available profiles: {available}"
+            )
+        return self.profiles[profile_name]
+
+
+def _ensure_config_dir() -> None:
+    """Create config directory if it doesn't exist."""
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+
+
+def load_config() -> Config:
+    """Load configuration from TOML file."""
+    if not CONFIG_FILE.exists():
+        raise FileNotFoundError(
+            f"Config file not found at {CONFIG_FILE}\n"
+            f"Run 'pmctl profile add <name> --api-key <key>' to create one."
+        )
+
+    with open(CONFIG_FILE, "rb") as f:
+        data = tomllib.load(f)
+
+    profiles = {}
+    for name, profile_data in data.get("profiles", {}).items():
+        profiles[name] = Profile(
+            name=name,
+            api_key=profile_data["api_key"],
+            label=profile_data.get("label", ""),
+            workspace=profile_data.get("workspace", ""),
+        )
+
+    if not profiles:
+        raise ValueError("No profiles found in config file.")
+
+    default = data.get("default_profile", next(iter(profiles)))
+    return Config(profiles=profiles, default_profile=default)
+
+
+def save_config(config: Config) -> None:
+    """Save configuration to TOML file."""
+    _ensure_config_dir()
+
+    lines = []
+    # Write top-level keys first (before any table sections)
+    lines.append(f'default_profile = "{config.default_profile}"')
+    lines.append("")
+
+    for name, profile in config.profiles.items():
+        lines.append(f"[profiles.{name}]")
+        lines.append(f'api_key = "{profile.api_key}"')
+        if profile.label:
+            lines.append(f'label = "{profile.label}"')
+        if profile.workspace:
+            lines.append(f'workspace = "{profile.workspace}"')
+        lines.append("")
+
+    CONFIG_FILE.write_text("\n".join(lines))
+
+
+def add_profile(name: str, api_key: str, label: str = "", workspace: str = "", set_default: bool = False) -> Config:
+    """Add a new profile to the config."""
+    try:
+        config = load_config()
+    except FileNotFoundError:
+        config = Config(profiles={}, default_profile=name)
+
+    config.profiles[name] = Profile(name=name, api_key=api_key, label=label, workspace=workspace)
+
+    if set_default or len(config.profiles) == 1:
+        config.default_profile = name
+
+    save_config(config)
+    return config
+
+
+def remove_profile(name: str) -> Config:
+    """Remove a profile from the config."""
+    config = load_config()
+
+    if name not in config.profiles:
+        raise ValueError(f"Profile '{name}' not found.")
+
+    del config.profiles[name]
+
+    if config.default_profile == name:
+        config.default_profile = next(iter(config.profiles), "")
+
+    save_config(config)
+    return config
+
+
+def set_default_profile(name: str) -> Config:
+    """Set the default profile."""
+    config = load_config()
+
+    if name not in config.profiles:
+        available = ", ".join(config.profiles.keys())
+        raise ValueError(f"Profile '{name}' not found. Available: {available}")
+
+    config.default_profile = name
+    save_config(config)
+    return config
+
+
+def set_profile_workspace(profile_name: str, workspace_id: str) -> Config:
+    """Set the default workspace for a profile."""
+    config = load_config()
+
+    name = profile_name or config.default_profile
+    if name not in config.profiles:
+        available = ", ".join(config.profiles.keys())
+        raise ValueError(f"Profile '{name}' not found. Available: {available}")
+
+    config.profiles[name].workspace = workspace_id
+    save_config(config)
+    return config

pmctl-0.1.0/uv.lock

@@ -0,0 +1,194 @@
+version = 1
+revision = 3
+requires-python = ">=3.11"
+
+[[package]]
+name = "annotated-doc"
+version = "0.0.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/57/ba/046ceea27344560984e26a590f90bc7f4a75b06701f653222458922b558c/annotated_doc-0.0.4.tar.gz", hash = "sha256:fbcda96e87e9c92ad167c2e53839e57503ecfda18804ea28102353485033faa4", size = 7288, upload-time = "2025-11-10T22:07:42.062Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1e/d3/26bf1008eb3d2daa8ef4cacc7f3bfdc11818d111f7e2d0201bc6e3b49d45/annotated_doc-0.0.4-py3-none-any.whl", hash = "sha256:571ac1dc6991c450b25a9c2d84a3705e2ae7a53467b5d111c24fa8baabbed320", size = 5303, upload-time = "2025-11-10T22:07:40.673Z" },
+]
+
+[[package]]
+name = "anyio"
+version = "4.12.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "idna" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/96/f0/5eb65b2bb0d09ac6776f2eb54adee6abe8228ea05b20a5ad0e4945de8aac/anyio-4.12.1.tar.gz", hash = "sha256:41cfcc3a4c85d3f05c932da7c26d0201ac36f72abd4435ba90d0464a3ffed703", size = 228685, upload-time = "2026-01-06T11:45:21.246Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/38/0e/27be9fdef66e72d64c0cdc3cc2823101b80585f8119b5c112c2e8f5f7dab/anyio-4.12.1-py3-none-any.whl", hash = "sha256:d405828884fc140aa80a3c667b8beed277f1dfedec42ba031bd6ac3db606ab6c", size = 113592, upload-time = "2026-01-06T11:45:19.497Z" },
+]
+
+[[package]]
+name = "certifi"
+version = "2026.1.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e0/2d/a891ca51311197f6ad14a7ef42e2399f36cf2f9bd44752b3dc4eab60fdc5/certifi-2026.1.4.tar.gz", hash = "sha256:ac726dd470482006e014ad384921ed6438c457018f4b3d204aea4281258b2120", size = 154268, upload-time = "2026-01-04T02:42:41.825Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e6/ad/3cc14f097111b4de0040c83a525973216457bbeeb63739ef1ed275c1c021/certifi-2026.1.4-py3-none-any.whl", hash = "sha256:9943707519e4add1115f44c2bc244f782c0249876bf51b6599fee1ffbedd685c", size = 152900, upload-time = "2026-01-04T02:42:40.15Z" },
+]
+
+[[package]]
+name = "click"
+version = "8.3.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/3d/fa/656b739db8587d7b5dfa22e22ed02566950fbfbcdc20311993483657a5c0/click-8.3.1.tar.gz", hash = "sha256:12ff4785d337a1bb490bb7e9c2b1ee5da3112e94a8622f26a6c77f5d2fc6842a", size = 295065, upload-time = "2025-11-15T20:45:42.706Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/98/78/01c019cdb5d6498122777c1a43056ebb3ebfeef2076d9d026bfe15583b2b/click-8.3.1-py3-none-any.whl", hash = "sha256:981153a64e25f12d547d3426c367a4857371575ee7ad18df2a6183ab0545b2a6", size = 108274, upload-time = "2025-11-15T20:45:41.139Z" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "h11"
+version = "0.16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/01/ee/02a2c011bdab74c6fb3c75474d40b3052059d95df7e73351460c8588d963/h11-0.16.0.tar.gz", hash = "sha256:4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1", size = 101250, upload-time = "2025-04-24T03:35:25.427Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/04/4b/29cac41a4d98d144bf5f6d33995617b185d14b22401f75ca86f384e87ff1/h11-0.16.0-py3-none-any.whl", hash = "sha256:63cf8bbe7522de3bf65932fda1d9c2772064ffb3dae62d55932da54b31cb6c86", size = 37515, upload-time = "2025-04-24T03:35:24.344Z" },
+]
+
+[[package]]
+name = "httpcore"
+version = "1.0.9"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "h11" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7e/f5/f66802a942d491edb555dd61e3a9961140fd64c90bce1eafd741609d334d/httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55", size = 78784, upload-time = "2025-04-24T22:06:20.566Z" },
+]
+
+[[package]]
+name = "httpx"
+version = "0.28.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "certifi" },
+    { name = "httpcore" },
+    { name = "idna" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
+]
+
+[[package]]
+name = "idna"
+version = "3.11"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/6f/6d/0703ccc57f3a7233505399edb88de3cbd678da106337b9fcde432b65ed60/idna-3.11.tar.gz", hash = "sha256:795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902", size = 194582, upload-time = "2025-10-12T14:55:20.501Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0e/61/66938bbb5fc52dbdf84594873d5b51fb1f7c7794e9c0f5bd885f30bc507b/idna-3.11-py3-none-any.whl", hash = "sha256:771a87f49d9defaf64091e6e6fe9c18d4833f140bd19464795bc32d966ca37ea", size = 71008, upload-time = "2025-10-12T14:55:18.883Z" },
+]
+
+[[package]]
+name = "markdown-it-py"
+version = "4.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "mdurl" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/5b/f5/4ec618ed16cc4f8fb3b701563655a69816155e79e24a17b651541804721d/markdown_it_py-4.0.0.tar.gz", hash = "sha256:cb0a2b4aa34f932c007117b194e945bd74e0ec24133ceb5bac59009cda1cb9f3", size = 73070, upload-time = "2025-08-11T12:57:52.854Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/94/54/e7d793b573f298e1c9013b8c4dade17d481164aa517d1d7148619c2cedbf/markdown_it_py-4.0.0-py3-none-any.whl", hash = "sha256:87327c59b172c5011896038353a81343b6754500a08cd7a4973bb48c6d578147", size = 87321, upload-time = "2025-08-11T12:57:51.923Z" },
+]
+
+[[package]]
+name = "mdurl"
+version = "0.1.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d6/54/cfe61301667036ec958cb99bd3efefba235e65cdeb9c84d24a8293ba1d90/mdurl-0.1.2.tar.gz", hash = "sha256:bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba", size = 8729, upload-time = "2022-08-14T12:40:10.846Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/38/89ba8ad64ae25be8de66a6d463314cf1eb366222074cfda9ee839c56a4b4/mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8", size = 9979, upload-time = "2022-08-14T12:40:09.779Z" },
+]
+
+[[package]]
+name = "pmctl"
+version = "0.1.0"
+source = { editable = "." }
+dependencies = [
+    { name = "httpx" },
+    { name = "rich" },
+    { name = "typer" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "httpx", specifier = ">=0.25.0" },
+    { name = "rich", specifier = ">=13.0.0" },
+    { name = "typer", specifier = ">=0.9.0" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.19.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b0/77/a5b8c569bf593b0140bde72ea885a803b82086995367bf2037de0159d924/pygments-2.19.2.tar.gz", hash = "sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887", size = 4968631, upload-time = "2025-06-21T13:39:12.283Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217, upload-time = "2025-06-21T13:39:07.939Z" },
+]
+
+[[package]]
+name = "rich"
+version = "14.3.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "markdown-it-py" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/74/99/a4cab2acbb884f80e558b0771e97e21e939c5dfb460f488d19df485e8298/rich-14.3.2.tar.gz", hash = "sha256:e712f11c1a562a11843306f5ed999475f09ac31ffb64281f73ab29ffdda8b3b8", size = 230143, upload-time = "2026-02-01T16:20:47.908Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ef/45/615f5babd880b4bd7d405cc0dc348234c5ffb6ed1ea33e152ede08b2072d/rich-14.3.2-py3-none-any.whl", hash = "sha256:08e67c3e90884651da3239ea668222d19bea7b589149d8014a21c633420dbb69", size = 309963, upload-time = "2026-02-01T16:20:46.078Z" },
+]
+
+[[package]]
+name = "shellingham"
+version = "1.5.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/58/15/8b3609fd3830ef7b27b655beb4b4e9c62313a4e8da8c676e142cc210d58e/shellingham-1.5.4.tar.gz", hash = "sha256:8dbca0739d487e5bd35ab3ca4b36e11c4078f3a234bfce294b0a0291363404de", size = 10310, upload-time = "2023-10-24T04:13:40.426Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e0/f9/0595336914c5619e5f28a1fb793285925a8cd4b432c9da0a987836c7f822/shellingham-1.5.4-py2.py3-none-any.whl", hash = "sha256:7ecfff8f2fd72616f7481040475a65b2bf8af90a56c89140852d1120324e8686", size = 9755, upload-time = "2023-10-24T04:13:38.866Z" },
+]
+
+[[package]]
+name = "typer"
+version = "0.23.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "annotated-doc" },
+    { name = "click" },
+    { name = "rich" },
+    { name = "shellingham" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/fd/07/b822e1b307d40e263e8253d2384cf98c51aa2368cc7ba9a07e523a1d964b/typer-0.23.1.tar.gz", hash = "sha256:2070374e4d31c83e7b61362fd859aa683576432fd5b026b060ad6b4cd3b86134", size = 120047, upload-time = "2026-02-13T10:04:30.984Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d5/91/9b286ab899c008c2cb05e8be99814807e7fbbd33f0c0c960470826e5ac82/typer-0.23.1-py3-none-any.whl", hash = "sha256:3291ad0d3c701cbf522012faccfbb29352ff16ad262db2139e6b01f15781f14e", size = 56813, upload-time = "2026-02-13T10:04:32.008Z" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.15.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" },
+]