unleashed-mail

UnleashedMail — Claude Code Plugin v2.2.2

A multi-agent development plugin for UnleashedMail, a native macOS 15+ email client supporting Gmail and Microsoft Graph, built with Swift 6, SwiftUI, AppKit, WKWebView, GRDB.swift (SQLCipher), and MVVM architecture.

20 agents · 17 skills · 3 commands

v2.2.0 introduces AGENT_CONTRACTS.md — the source of truth for cross-agent boundaries (release contract, plan-implement gate, data→logic→ui handoff, AI pipeline ownership, code review pipeline, CI pinning, MCP tool prefixes, mandatory project gates). When two agents disagree about a boundary, the contracts doc wins.

What's New

v2.2.2

• Review skills promoted into the plugin — gemini-review, codex-review, and create-feature-plan were previously workspace-only skills referenced by the plugin's docs but not bundled. They now ship with the plugin under their namespaced slash commands: /unleashed-mail:gemini-review, /unleashed-mail:codex-review, /unleashed-mail:create-feature-plan.
• gemini-review rewritten for Antigravity (agy) — replaces the retired gemini-cli binary, removes obsolete -m/-o flags, documents the TTY-only "text drip" print mode and the Python pty.openpty() wrapper recipe required to capture agy's output from non-TTY contexts (Bash automation, CI scripts).
• codex-review portability fix — removed user-specific absolute path from the "working directory" note; references the workspace root abstractly so the skill is portable across installs.
• All plugin docs renamed slash-command refs — CLAUDE.md, README.md, AGENT_CONTRACTS.md, agents/modern-standards-planner.md now reference the namespaced commands.
• Skill count: 17 (was 14) — adds gemini-review, codex-review, create-feature-plan.

v2.2.1

• Antigravity CLI migration — Google retired Gemini CLI in May 2026; the dual-review gate now invokes Antigravity CLI (binary agy, model gemini-3.1-pro). Agent docs (modern-standards-planner, release-manager), AGENT_CONTRACTS.md, and CLAUDE.md updated.
• Model name updated — gemini-3.1-pro graduated out of preview. References to gemini-3.1-pro-preview removed.

v2.2.0

• New file: AGENT_CONTRACTS.md — formalizes cross-agent boundaries. Source of truth when agents disagree on workflow contracts.
• 20 agents (up from 15) — adds tester, code-simplifier, docs-engineer, ci-engineer, release-manager.
• 14 skills (up from 10) — adds error-handling, accessibility-patterns, swiftlint-config, spm-management.
• Subagent dispatcher fix — uses Agent (Claude Code's correct tool name), not Task. Fixed in 5 agent + 4 command/skill frontmatters.
• MCP portability — Atlassian and Context7 whitelist all three install prefixes (standalone, VSCode-shipped, plugin-namespaced) so the plugin works regardless of MCP install.
• Project rule alignment with the consumer project's .claude/rules/*.md system: AccountScopedServiceProvider for service resolution, @State (not computed property) for views, Curator design tokens, COREDEV-1578 Sendable matrix, image budget tiers, two-layer HTML pipeline (HTMLSanitizer + HTMLRenderPipeline), inline AI safety (AISafetyPipeline is PLANNED, not shipped), BaseAIProvider for Apple Intelligence, snake_case SQL columns, append-only migrations.
• Project knowledge corrected fleet-wide — quoted scheme name ("Unleashed Mail"), xcodebuild test everywhere (this is .xcodeproj, not SwiftPM), version scheme MAJOR.MINORRELEASE.YYMMBB per docs/VERSIONING.md, branch convention 1.0X/feature-name, version-bump automation acknowledged.
• Dangerous recommendations removed — cert pinning for Google/Microsoft OAuth (they rotate certs), sandbox-disable workaround for Keychain prompts, append-only migrations no longer paired with rollback scripts.
• Cross-agent inconsistencies resolved — GitHub Actions SHA-pinned everywhere, jira-manager ticket-before-code rule with manual fallback, diagnostic agents have explicit Ask-before checkpoints for entitlements/auth/dependencies/toolbar/keyboard.
• Hooks/scripts portability — test-runner.sh removed from Bash hook (was running full test suite after every Bash command), null-delimited PII scan, no xargs -a (BSD-incompatible), no <<< here-strings (require writable /tmp), explicit refspec for git fetch so CI works on fresh clones.
• jira-manager knows the Atlassian site — embedded https://unleashedservices.atlassian.net/ and project key COREDEV so it stops using placeholder URLs.
• smb-entrepreneur and enterprise-stakeholder — gain Grep+Glob so they can search project docs while stress-testing proposals.

15 rounds of Codex review iteration before merge. See PR #2 for the audit detail.

Installation