mcpField
P
paw-mail-usage

paw-mail-usage

github.com/pawpair生产力0276 次安装29 周前更新
代码仓库

关于 paw-mail-usage

paw-mail-usage 是 paw-mail 邮件命令行工具的使用指南，面向需要在终端管理邮件账户和邮件的用户。它涵盖认证、账户操作、邮件处理及同步命令。

主要功能

  1. 01OAuth 设备流登录
  2. 02管理邮件账户
  3. 03列出、搜索和读取邮件
  4. 04查看并触发账户同步
  5. 05支持表格等输出格式

适用场景

  1. 01在终端添加或切换邮件账户
  2. 02搜索并读取指定文件夹邮件
  3. 03查看账户同步状态和历史
  4. 04排查认证或密钥环问题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/pawpair/paw-mail-cli --skill paw-mail-usage

安装后在 Claude Code 中输入/paw-mail-usage确认已加载。

详细介绍

Paw Mail CLI

CLI 通过 paw-mail-cli 仓库以预构建二进制文件的形式分发。使用前必须先安装。

安装

# 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

二进制文件

二进制文件说明
paw-mail统一 CLI + TUI（推荐）
paw-mail-tui仅终端用户界面

以下示例均使用 paw-mail。可以通过 paw-mail-tui 或 paw-mail tui 启动 TUI。

全局标志

这些标志必须放在子命令之前：

标志环境变量说明
--server <url>MAIL_SERVERgRPC 后端地址
--format <table|json>—输出格式（默认：table）
--auth-backend <auto|keyring|file>MAIL_AUTH_BACKEND令牌存储后端
-v, --verbose—启用调试日志

子命令

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

配置会缓存在本地的 ~/.local/pawpair/config.json（或 ~/.pawpair/config.json）。首次运行时会自动从远程配置服务进行引导。

身份验证
paw-mail auth login      # OAuth device flow login
paw-mail auth status     # Show auth state + backend
paw-mail auth logout     # Clear stored tokens
账户
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
邮件
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>
同步
paw-mail sync status --account-id <id>
paw-mail sync trigger --account-id <id>
paw-mail sync history --account-id <id>
会话
paw-mail threads list --account-id <id>
paw-mail threads get --thread-id <id> --account-id <id>

身份验证后端

# 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

常见问题

  • command not found: paw-mail — CLI 尚未安装。请参阅上方的安装部分。
  • Keyring write failed: locked collection — GNOME Keyring 已锁定。请使用 --auth-backend file 或解锁 Keyring。
  • Could not open browser — 当前为无头/SSH 会话。请手动复制打印出的 URL。

评论

支持 Markdown