pawpair/paw-mail-cli · Archived

paw-mail-usage

How to use the Paw Mail CLI (paw-mail). Use this skill when: (1) you need to run a CLI command (auth, accounts, emails, sync, threads, config), (2) someone asks how to use or invoke the mail CLI, (3) you need to check CLI flags or subcommands.

First seen Mar 1, 2026

Installation

$ npx skills add pawpair/paw-mail-cli --skill paw-mail-usage

View on skills.sh ↗ GitHub repository ↗

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

mail-cli-usage Same source

pawpair/paw-mail-cli

How to build and run the mail CLI tool during development. Use this skill when: (1) you need to…

2 installs

spawn Similar · more installs

alirezarezvani/claude-skills

Launch N parallel subagents in isolated git worktrees to compete on the session task. Use when …

1.4K installs

capawesome-cloud Similar · more installs

capawesome-team/skills

Guides the agent through setting up and using Capawesome Cloud for Capacitor and Cordova apps. …

497 installs

agentica-spawn Similar · more installs

parcadei/continuous-claude-v3

Spawn Agentica multi-agent patterns

465 installs

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

copilot-usage-metrics Similar name

github/awesome-copilot

Retrieve and display GitHub Copilot usage metrics for organizations and enterprises using the G…

8.8K installs

aws-sdk-js-v3-usage Similar name

aws/agent-toolkit-for-aws

AWS SDK for JavaScript v3 development patterns. Use when writing JavaScript or TypeScript code …

6K installs

aws-sdk-python-usage Similar name

aws/agent-toolkit-for-aws

AWS SDK for Python (boto3/botocore) development patterns. You MUST use this skill when writing …

5.9K installs

aws-sdk-swift-usage Similar name

aws/agent-toolkit-for-aws

AWS SDK for Swift development patterns. Use when writing Swift code that uses AWS services via …

4.8K installs

package-usage Similar name

pulumi/agent-skills

Track which stacks across a Pulumi organization use a specific package and at what versions. Us…

1 installs

opencli-usage Similar name

jackwener/opencli

Use at the start of any OpenCLI session — this is the top-level map of what `opencli` can do, h…

19.6K installs

Also in this package

Other skills from pawpair/paw-mail-cli.

npx skills add pawpair/paw-mail-cli

mail-cli-usage 2

Browse all from pawpair/paw-mail-cli

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared

Cursor Not declared

Codex Not declared

GitHub Copilot Not declared

Windsurf Not declared

Gemini CLI Not declared

Cline Not declared

OpenCode Not declared

Repository health

License LICENSE

Default branch main

Open issues 0

Status Archived

Skill metadata

Parsed from SKILL.md frontmatter.

Version3.0.0

LicenseMIT

CompatibilityLinux x86_64/aarch64, macOS x86_64/aarch64

Allowed toolsBash(paw-mail:*) Bash(paw-mail-tui:*) Read Glob Grep

More metadata

author: pawpair
version: 3.0.0

Package contents

Files included with this skill beyond the listing page.

skill md SKILL.md 4,403 B
docs SUMMARY.md 265 B

History

Mar 1, 2026 First seen on skills.sh
Sep 9, 2026 First recorded snapshot · 169 installs

SKILL.md

Paw Mail CLI

The CLI is distributed as pre-built binaries via the paw-mail-cli repository. It must be installed before use.

Installation

# Nix (recommended)
nix profile install 'github:pawpair/paw-mail-cli?dir=nix#paw-mail'

# Homebrew (macOS / Linux)
brew tap pawpair/paw-mail-cli && brew install paw-mail

# Arch Linux (AUR)
yay -S paw-mail-bin

# Debian / Ubuntu — download .deb from latest release
# https://github.com/pawpair/paw-mail-cli/releases/latest
sudo dpkg -i paw-mail_*_amd64.deb

Binaries

Binary	Description
`paw-mail`	Unified CLI + TUI (recommended)
`paw-mail-tui`	Terminal user interface only

All examples below use paw-mail. The TUI can be launched with paw-mail-tui or paw-mail tui.

Global Flags

These flags go before the subcommand:

Flag	Env Var	Description
`--server <url>`	`MAIL_SERVER`	gRPC backend address
`--format <table\	json>`	—	Output format (default: table)
`--auth-backend <auto\	keyring\	file>`	`MAILAUTHBACKEND`	Token storage backend
`-v, --verbose`	—	Enable debug logging

Subcommands

Config

paw-mail config refresh  # Fetch remote config and cache locally
paw-mail config show     # Show current config values

Config is cached locally at ~/.local/pawpair/config.json (or ~/.pawpair/config.json). First run bootstraps automatically from the remote config service.

Auth

paw-mail auth login      # OAuth device flow login
paw-mail auth status     # Show auth state + backend
paw-mail auth logout     # Clear stored tokens

Accounts

paw-mail accounts list
paw-mail accounts get --provider <google|microsoft>
paw-mail accounts add --email <e> --provider <google|microsoft>  # Opens browser for OAuth
paw-mail accounts delete --provider <google|microsoft>
paw-mail accounts activate --id <uuid>
paw-mail accounts deactivate --id <uuid>
paw-mail accounts oauth-clients            # List user OAuth clients
paw-mail accounts oauth-clients --system   # List system OAuth clients

Emails

paw-mail emails folders --provider <p> --email <e>
paw-mail emails list --provider <p> --email <e> --folder INBOX [--limit 50]
paw-mail emails fetch --provider <p> --email <e> --folder INBOX --uid <n>
paw-mail emails body --provider <p> --email <e> --folder INBOX --uid <n>
paw-mail emails search --provider <p> --email <e> --folder INBOX --query <q>
paw-mail emails read --provider <p> --email <e> --folder INBOX --uid <n>
paw-mail emails unread --provider <p> --email <e> --folder INBOX --uid <n>
paw-mail emails flag --provider <p> --email <e> --folder INBOX --uid <n> [--unflag]
paw-mail emails move --provider <p> --email <e> --folder INBOX --uid <n> --destination Trash
paw-mail emails delete --provider <p> --email <e> --folder INBOX --uid <n>

Sync

paw-mail sync status --account-id <id>
paw-mail sync trigger --account-id <id>
paw-mail sync history --account-id <id>

Threads

paw-mail threads list --account-id <id>
paw-mail threads get --thread-id <id> --account-id <id>

Auth Backends

# Auto-detect (default) — tries keyring, falls back to file
paw-mail auth status

# Force file-based storage
paw-mail --auth-backend file auth status

# Force keyring (errors if unavailable)
paw-mail --auth-backend keyring auth status

# Verbose to see backend selection
paw-mail -v auth status

Common Issues

command not found: paw-mail — The CLI is not installed. See Installation above.
Keyring write failed: locked collection — GNOME Keyring is locked. Use --auth-backend file or unlock your keyring.
Could not open browser — Headless/SSH session. Copy the printed URL manually.

npx skills add pawpair/paw-mail-cli --skill paw-mail-usage