pylon-cli

CLI for Pylon — for humans and AI agents.

Setup

npm install
cp .env.example .env
# Add your Pylon API token to .env

Get your API token from Pylon's developer settings.

Global install (optional)

npm link

Then use pylon from anywhere.

Usage

# All commands support --json for machine-readable output
pylon [command] --json

# Show current user
pylon me

# Issues
pylon issues                              # List issues (last 30 days)
pylon issues --since 2024-01-01           # Issues since date
pylon issue <id>                          # Get single issue
pylon issue-search -q "bug" -s open       # Search by title + state
pylon issue-search --team <id> --tag urgent
pylon issue-create -t "New bug" -b "Details here" --tags bug,urgent
pylon issue-update <id> -s closed
pylon issue-update <id> -a <user-id> --team <team-id>

# Messages
pylon messages <issue-id>                 # List messages on issue
pylon reply <issue-id> -m "Thanks!"       # Reply to issue
pylon note <issue-id> -m "Internal note"  # Add internal note

# Accounts
pylon accounts                            # List all
pylon account <id>                        # Get one
pylon account-search -q "Acme"            # Search by name
pylon account-search -d "acme.com"        # Search by domain

# Contacts
pylon contacts                            # List all
pylon contact <id>                        # Get one
pylon contact-search -q "John"            # Search by name
pylon contact-search -e "john@acme.com"   # Search by email

# Tags
pylon tags                                # List all
pylon tag-create --name "urgent"          # Create
pylon tag-delete <id>                     # Delete

# Teams
pylon teams                               # List all
pylon team <id>                           # Get one

# Users
pylon users                               # List all
pylon user-search -q "Jane"               # Search by name

# Knowledge Base
pylon kb                                  # List knowledge bases
pylon articles <kb-id>                    # List articles
pylon article <kb-id> <article-id>        # Get article
pylon article-create <kb-id> -t "Title" --author <user-id> -b "<p>Content</p>"
pylon article-delete <kb-id> <article-id>

AI Agent Usage

Pass --json to get structured output suitable for programmatic consumption:

pylon issues --json | jq '.data[] | {id, title, state}'
pylon issue-search -s open --json