Corky

Alpha software. Expect breaking changes between minor versions. See VERSIONS.md for migration notes.

Full documentation: https://btakita.github.io/corky

Sync email threads from IMAP to Markdown. Draft replies with AI assistance. Share scoped threads with collaborators via git.

Corky syncs threads from any IMAP provider (Gmail, Protonmail Bridge, self-hosted) into mail/conversations/ — one file per thread, regardless of source. A thread that arrives via both Gmail and Protonmail merges into one file. Labels, accounts, and contacts are metadata, not directory structure.

Install

curl -sSf https://raw.githubusercontent.com/btakita/corky/main/install.sh | sh

Or from source: cargo install --path .

Quick start

corky init --user you@gmail.com
# Edit mail/.corky.toml with credentials
corky sync

See the getting started guide for full setup instructions.

Key features

• Flat conversations — one Markdown file per thread, all sources merged
• Sandboxed sharing — label-based routing gives collaborators only the threads you choose
• AI-native — files, CLI, and git work the same for humans and agents
• Multi-account — Gmail, Protonmail Bridge, generic IMAP, all in one directory
• Watch daemon — poll IMAP on an interval with corky watch

Usage

corky sync                      # Incremental IMAP sync
corky find-unanswered           # Threads awaiting a reply
corky push-draft FILE           # Save as email draft
corky mailbox add NAME --label LABEL  # Share threads
corky watch                     # Poll and sync automatically
corky --help                    # All commands

See the command reference for details.

Development

cp .corky.toml.example mail/.corky.toml
make check    # clippy + test
make release  # build + symlink to .bin/corky

See building and conventions.

AI agent instructions

Project instructions live in AGENTS.md (symlinked as CLAUDE.md). Personal overrides go in CLAUDE.local.md / AGENTS.local.md (gitignored).