— Section 2
Install
Homebrew

Tek satır. İmzalı.

2.1

Homebrew tap

brew tap jasonhollis/boogie && brew install jmapcli — tek bir imzalı ikili dosya, derlenecek bağımlılık yok. Yükseltmeler şununla: brew upgrade.

— macOS
Apple silicon

2.2

Keychain kimlik doğrulaması

Kimlik bilgileri macOS oturum açma Keychain'inden JMAP kimliğine göre okunur. dotfiles'da hiçbir şey, env vars'da hiçbir şey yok.

— security
find-generic

2.3

Telemetri yok

Araç hiçbir yere veri göndermez. Dokunduğu tek ağ kendi JMAP sunucunuzdur.

— zero
SDKs

03.

— Section 3
Credentials
macOS Keychain

Şifreniz hiçbir zaman diske dokunmaz.

jmapcli diskte hiçbir sır saklamaz. Şifreniz (veya bearer token’ınız) macOS oturum açma Keychain’inde yaşar; hesap dosyası — ~/.config/jmapcli/config.json, mod 0600 — yalnızca sunucu URL’sini, kullanıcı adınızı ve varsayılan bir bayrağı tutar. Terminalden Keychain’e yeni misiniz? Tüm iş akışı, yerleşik üç security komutundan ibarettir.

1 · Bir sır saklayın — ve geri okuyun. macOS değer için bir istem gösterir; bu sayede sır hiçbir zaman komut satırına yazılmaz, ekranda görünmez ve kabuk geçmişinize kaydedilmez.

# store it — you’re prompted for the secret, nothing echoes
$ security add-generic-password -U -s jmap-password -a you@example.com -l "Boogie JMAP password" -w

# read it back at any time
$ security find-generic-password -s jmap-password -a you@example.com -w

# remove it
$ security delete-generic-password -s jmap-password -a you@example.com

-s: service — jmapcli’nin aradığı ad: parola için jmap-password ya da bearer token için jmap-token (örn. Fastmail); yalnızca kullandığınızı ayarlayın.
-a: account — e-posta adresiniz (jmapcli’ye verdiğiniz kullanıcı adının aynısı).
-l: label — Keychain Access uygulamasında göreceğiniz ad; -U mevcut bir öğeyi yerinde günceller.
-w: değer olmadan — sır için istem göster. Bu, sırı ~/.zsh_history dosyasından ve işlem listesinden uzak tutan kısımdır.

2 · jmapcli’yi sunucunuza yönlendirin. Hesabı bir kez kaydedin; sır doğrudan az önce sakladığınız Keychain öğesinden çekilir ve komut satırında hiç görünmez.

$ jmapcli login --url https://mail.example.com --username you@example.com \
      --password "$(security find-generic-password -s jmap-password -a you@example.com -w)"
# token auth: swap --password for --token (and store under jmap-token above)
$ jmapcli list      # from here on, every command reads the Keychain for you

3.1

Geçmişinizde, günlüklerinizde — ya da bir yapay zekanın bağlamında hiçbir şey yok

Sır Keychain’de olduğunda, gündelik komutlar (list, send, draft, sync) hiçbir zaman parola taşımaz; bu nedenle sır ~/.zsh_history dosyasında, işlem listesinde veya CI günlüklerinde yakalanamaz. jmapcli’yi terminal-AI araçlarından güvenle kullanmanızı sağlayan da budur — bir ajana JMAP istemcisi verilir, sırrınız asla.

— zsh
CI · agents

3.2

Döndür veya çıkış yap

Şifrenizi mi değiştirdiniz? security add-generic-password … -w satırını yeniden çalıştırın — -U onu yerinde üzerine yazar. Bir hesabı kaldırmak için jmapcli logout, hem yapılandırma girişini hem de Keychain sırrını tek adımda siler (--all her hesabı temizler).

— rotate
logout

3.3

Tasarımı gereği Mac başına

Oturum açma Keychain’i iCloud üzerinden eşitlenmez — bu bilinçli bir sınırdır; şifreniz onu yazdığınız Mac’ten hiçbir zaman ayrılmaz. security adımını Mac başına bir kez tekrarlayın; config.json hiçbir sır taşımadığından eşitlenmiş bir ana klasörde bulunabilir.

— per
machine

04.

— Section 4
Commands
One verb each

Her şey bir alt komuttur.

login

Bir JMAP sunucusunun kimlik bilgilerini Keychain'de saklayın

discover

Sunucudan JMAP oturumunu keşfedin

accounts

Yapılandırılmış hesapları ve gönderim yapabilen tüm kimlikleri listele

mailboxes

Tüm posta kutularını listeleyin

list

Bir posta kutusundaki e-postaları listeleyin

search

Postayı metne, konuya, gönderene, alıcıya veya gövdeye göre ara (sunucu taraflı)

read

E-postanın tam içeriğini görüntüleyin (Markdown olarak işlenir)

send

JMAP Submission ile, gönderim yapabilen herhangi bir kimlikten e-posta gönder (--from)

reply

Bir iletiyi ID ile yanıtla; konu zincirine ekleyerek ve orijinali alıntılayarak

forward

Bir iletiyi ID ile ilet; eklerini yeniden ekleyerek

draft

Bir e-postayı göndermeden Drafts içinde hazırla

move · trash · delete

Bir posta kutusuna taşıyın, Çöp Kutusu'na taşıyın veya kimliğe göre kalıcı olarak silin

sync

Delta eşitlemesi yapın ve neyin değiştiğini gösterin

contacts

JSContact kişileri: listele, ekle, düzenle, kaldır, takma adları içe aktar

calendar

Takvimleri ve etkinlikleri listele, etkinlik yaz, takvim renklerini ayarla

sieve

Sunucu taraflı Sieve filtrelerini listele, getir, doğrula ve gönder

alias

Alıcı takma adlarını yönetin

mcp

AI araçları için bir Model Context Protocol sunucusu olarak çalıştırın

logout

Saklanan kimlik bilgilerini kaldırın

05.

— Section 5
Changelog
Every release

Yenilikler.

v1.4.0

Full-text search (text, subject, from, to, body); threaded reply and forward; draft — stage in Drafts without sending; multi-account: accounts and identities, and send/reply/forward as any sendable identity via --from; contacts import-aliases; faster multi-recipient sends. — 2026-06-24

v1.3.1

Calendar event write (add, edit, remove); offline-first hardening. — 2026-06-20

v1.3.0

JSContact contacts — read and write, with a lossless round-trip. — 2026-06-15

v1.2.0

Sieve filters — list, get, validate, and push server-side mail rules. — 2026-06-12

v1.1.0

Calendar — list calendars and events, set colours. — 2026-06-11

v1.0.0

Initial release — send, read, search, sync, and triage mail from the terminal, credentials in the macOS Keychain. — 2026-06-06

Komut satırından JMAP.

Tek satır. İmzalı.

Şifreniz hiçbir zaman diske dokunmaz.

Her şey bir alt komuttur.

Yenilikler.

Tam uygulamayı ister misiniz?