Sync email threads from IMAP to Markdown, draft replies, manage collaborators
Project description
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
pip install corky # or: pipx install corky
Or via shell installer:
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 unanswered # Threads awaiting a reply
corky draft push 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).
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file corky-0.7.3.tar.gz.
File metadata
- Download URL: corky-0.7.3.tar.gz
- Upload date:
- Size: 113.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"CachyOS Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c088df6c67f67d4d173469d4f470ceb86a0c902913471374abb1d9839383bd6a
|
|
| MD5 |
acbf61943ca96b9f5948d46975abfa3c
|
|
| BLAKE2b-256 |
3f82788f4a22e367b32d826ffc55acd28e9b64c8fee27ffe013ed88c6fcd3e92
|
File details
Details for the file corky-0.7.3-py3-none-manylinux_2_39_x86_64.whl.
File metadata
- Download URL: corky-0.7.3-py3-none-manylinux_2_39_x86_64.whl
- Upload date:
- Size: 5.2 MB
- Tags: Python 3, manylinux: glibc 2.39+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"CachyOS Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
baf3dc3e7ecc5190625be75977591e9ed5931d52b3fa738e33089416ad851d9b
|
|
| MD5 |
7a65584ceb3d51b06354d566aec8fe41
|
|
| BLAKE2b-256 |
6faa8716d086e155ff23dcfd98955f2a06a978ed63ae667b43b6327190be29e9
|
