pmctl 0.1.2

A CLI tool for managing Postman collections, environments, and workspaces

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 to let you browse and manage your Postman resources from the terminal.

Features

• 🔑 Multi-profile support — manage multiple Postman accounts with default workspaces
• 📦 Browse collections — list collections, inspect with tree view, and drill into individual requests
• 🌍 Environments — list environments and view variables by name or ID
• 🏢 Workspaces — list and search workspaces
• 🐚 Shell completion — tab completion for bash, zsh, and fish
• 🎨 Rich output — colored tables and trees powered by Rich

Installation

pip install pmctl

Or install from source:

git clone https://github.com/wbingli/pmctl.git
cd pmctl
pip install -e .

Quick Start

1. Add a profile

# 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. Set a default workspace

# Set default workspace for your profile (so list commands scope to it automatically)
pmctl profile set-workspace <workspace-id>

3. Browse your resources

# List collections (scoped to default workspace)
pmctl collections list

# List collections from all workspaces
pmctl collections list --all

# Show all requests in a collection (tree view)
pmctl collections show <collection-uid>

# Inspect a specific request by name
pmctl collections request <collection-uid> "request name"

# List environments
pmctl environments list

# Show environment variables (by name or ID)
pmctl environments show "My Environment"
pmctl environments show <env-id>

# List workspaces
pmctl workspaces list

# Search workspaces by name
pmctl workspaces list --search "keyword"

4. Switch between profiles

# 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

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 set-workspace <workspace>   # Set default workspace for profile
pmctl profile whoami                      # Show current user info

Configuration

Profiles are stored in ~/.config/pmctl/config.toml:

[profiles.personal]
api_key = "PMAK-..."
label = "[e-mail]"

[profiles.work]
api_key = "PMAK-..."
label = "[e-mail]"
workspace = "your-workspace-id"

default_profile = "work"

Getting a Postman API Key

1. Go to Postman 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.

Shell Completion

# Bash
eval "$(pmctl completion bash)"

# Zsh
eval "$(pmctl completion zsh)"

# Fish
pmctl completion fish > ~/.config/fish/completions/pmctl.fish

License

MIT