Auto-discovered marketplace from wbingli/pmctl
npx claudepluginhub wbingli/pmctlBrowse and inspect Postman collections, requests, and environments from the terminal. Discover API endpoints, resolve environment variables, and construct curl commands.
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.
pip install pmctl
Or install from source:
git clone https://github.com/wbingli/pmctl.git
cd pmctl
pip install -e .
# 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"
# Set default workspace for your profile (so list commands scope to it automatically)
pmctl profile set-workspace <workspace-id>
# 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>
# List all requests in a collection (flat table, by name or UID)
pmctl requests list --collection "My Collection"
pmctl requests list -c <collection-uid>
# Fuzzy search requests (characters matched in order, e.g. "crtUsr" matches "Create User")
pmctl requests list -c "My Collection" --search "getUser"
# Inspect a specific request by name
pmctl requests show "Create User" --collection "My Collection"
# JSON output for scripting
pmctl requests list -c "My Collection" --json
pmctl requests show "Create User" -c "My Collection" --json
# 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"
# 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
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
Profiles are stored in ~/.config/pmctl/config.toml:
[profiles.personal]
api_key = "PMAK-..."
label = "personal@example.com"
[profiles.work]
api_key = "PMAK-..."
label = "work@company.com"
workspace = "your-workspace-id"
default_profile = "work"
pmctl profile addNote: 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.
# Bash
eval "$(pmctl completion bash)"
# Zsh
eval "$(pmctl completion zsh)"
# Fish
pmctl completion fish > ~/.config/fish/completions/pmctl.fish
pmctl is designed to be used by both humans and AI agents. It ships with skill/plugin definitions for all major AI coding tools.
This repo is a Claude Code plugin. Install it directly inside Claude Code:
claude plugin marketplace add wbingli/pmctl
claude plugin install pmctl@pmctl
Skills are in .agents/skills/pmctl/SKILL.md following the Agent Skills standard. Codex picks them up automatically when you work inside this repo, or copy the skill folder to ~/.agents/skills/pmctl/ for global access.