PortEden CLI

Manage your calendar and email from the terminal. List events, search across calendars, create and update meetings, send and manage emails, respond to invitations, and check availability — all from the command line.

Commands Reference

All CLI commands and flags

Usage & Config

Output formats, env vars, and more

Installation

Homebrew (macOS / Linux)

brew install porteden/tap/porteden

Install Script

curl -sSfL https://raw.githubusercontent.com/porteden/cli/main/install.sh | bash

Go Install

go install github.com/porteden/cli/cmd/porteden@latest

Authentication

Interactive Login

The easiest way to authenticate. Opens your browser to complete the login flow:

# Interactive login (opens browser)
porteden auth login 
 
# Name your key for easy identification
porteden auth login --title "Work Laptop"

Direct Token

For non-interactive environments, pass your API key directly:

# Direct token (non-interactive)
porteden auth login --token pe_your_api_key

Verify

Check your authentication status:

porteden auth status

Example Output

Profile: default
Authenticated as: you@example.com
Operator: Acme Corp
Key ID: 42
Key title: Work Laptop
Key created: 2026-01-15

Environment Variable

Instead of auth login, set your API key directly. Useful for CI/CD pipelines and automation:

export PE_API_KEY=pe_your_api_key

Credential Storage

API keys are stored in your system's secure credential store:

Platform	Storage
macOS	Keychain
Linux	Secret Service (gnome-keyring / kwallet)
Windows	Credential Manager

Headless environments

For CI/CD, enable file-based storage by setting CI=true before running porteden auth login, or use the --insecure-storage flag. Keys are stored in plaintext at ~/.config/porteden/credentials.

Getting Help

porteden --help 
porteden calendar --help 
porteden calendar events --help 
porteden email --help 
porteden email messages --help 
porteden auth --help