pidge 1.1.2

Status

Early days. pidge can sign in to one or more Microsoft 365 / personal Microsoft accounts, browse / search / send / reply to e-mail, manage drafts + attachments, and manage calendars — create / edit / search / reschedule / cancel / duplicate events, move between calendars, RSVP, and create recurring meetings.

Quick Start

# 1. Install (macOS / Linux)
brew install mklab-se/tap/pidge
# ...or via cargo: cargo install pidge
# ...other options (pre-built binaries, cargo binstall): see INSTALL.md

# 2. Sign in (opens your browser)
pidge account add

# 3. Try it
pidge mail
pidge calendar

See INSTALL.md for all installation methods and shell completions.

Built for AI agents

pidge is designed to be operated by AI coding agents — Claude Code, Codex, Copilot, etc. — on your behalf. You can run it directly too, but the primary surface is your agent.

Wire it into your agent with one command:

pidge ai skill --emit > ~/.claude/skills/pidge/SKILL.md
# or, if you run pidge from a source checkout instead of `cargo install`:
pidge ai skill --emit --from-source > ~/.claude/skills/pidge/SKILL.md

The emitted skill is deliberately small: it teaches the agent the concept plus a handful of patterns (JSON output, confirmation gates, account context) and tells it to use pidge --help for live command discovery — so the skill keeps working as pidge ships new functionality.

Account setup

# Add an account (opens your browser — auth code + PKCE)
pidge account add

# List signed-in accounts and which one is default for e-mail / calendar
pidge account list

# Remove an account (interactive picker if more than one is signed in)
pidge account remove

The first account you add becomes the default for both e-mail and calendar; change either with:

pidge account default e-mail   <email>
pidge account default calendar <email>
pidge account default              # prints both currents

Sign in to multiple accounts and pidge merges reads across all of them by default.

Reading the inbox

# Shortcut: list 25 most recent across every signed-in account
pidge mail

# Shortcut: open a specific message by a fragment of its 8-char ID
pidge mail 3515

# Explicit forms
pidge mail list --account kristofer@mklab.se --unread -n 50
pidge mail show 3515 --mark-read

# Pipe to scripts
pidge mail --json | jq '.[].subject'

Calendar

# Shortcut: list events for today + next 7 days across every account
pidge calendar

# Canned windows
pidge calendar --today
pidge calendar --tomorrow
pidge calendar --week
pidge calendar --month

# Open one event by fragment of its 8-char hash
pidge calendar 4cabda75

# Schedule a meeting with attendees and a Teams URL
pidge calendar new \
  --title "Q3 planning" \
  --start "tomorrow 15:00" --end "+90m" \
  --invite alice@example.com,bob@example.com \
  --location "Office" --online

# Recurring weekly team sync
pidge calendar new \
  --title "Team sync" \
  --start "next mon 09:00" --end "+30m" \
  --repeat weekly --on mon --until 2026-12-31

# Reschedule
pidge calendar move-time 4cabda75 --start "fri 14:00"

# Cancel (organizer-only; sends notices to attendees)
pidge calendar cancel 4cabda75 --comment "Postponed to next week"

# RSVP to someone else's invite
pidge calendar rsvp 4cabda75 --accept

# Pipe to scripts
pidge calendar --json --week | jq '.[] | .subject'

AI Integration

pidge delegates AI configuration to ailloy, a unified AI provider library shared by the MKLab CLI suite (rigg, mdeck, cosq, pidge). Configure your provider once:

pidge ai config    # configure your AI provider
pidge ai status    # check status

and it's available to every ailloy-based tool.

Development

cargo build              # Build
cargo test --workspace   # Run tests
cargo clippy             # Lint
cargo fmt                # Format

See CONTRIBUTING.md for the contributor guide.

Releasing

Releases are driven by the /release skill (run it in Claude Code with major, minor, or patch). It updates the toolchain and dependencies, runs the CI gates, bumps the version, updates the changelog, then commits, pushes, and tags vX.Y.Z. Pushing the tag triggers .github/workflows/release.yml, which:

1. Re-runs the full CI suite
2. Builds auditable binaries for Linux, macOS (Intel + ARM), and Windows, with a CycloneDX SBOM per target
3. Creates a GitHub Release with the archives and SBOMs (see INSTALL.md for how to read them)
4. Publishes pidge-core, then pidge-client, then pidge to crates.io
5. Updates the Homebrew formula in mklab-se/homebrew-tap

Required secrets

Configure these once on the GitHub repository (the same secrets are used by the other MKLab tools):

If HOMEBREW_TAP_TOKEN is missing, the release still succeeds — the Homebrew step just logs a warning.

Changelog

Curious what's new? See CHANGELOG.md for the full history of changes, newest first.

License

MIT — see LICENSE.