Boogie
jmapcli · JMAP kutoka terminal
01.
v1.4.0 · macOS
Programu asilia ya JMAP ya mstari wa amri.

JMAP kutoka mstari wa amri.

jmapcli huzungumza JMAP na Stalwart (na seva yoyote ya JMAP) moja kwa moja kutoka kwa terminal yako — tuma, soma, tafuta, sawazisha, hamisha na simamia barua. Swift asilia, vitambulisho katika macOS Keychain, hakuna telemetria.

$ brew tap jasonhollis/boogie && brew install jmapcli $ jmapcli login # imehifadhiwa katika macOS Keychain $ jmapcli send --to you@example.com --subject "Hi" --body "From the CLI"
02.
— Section 2
Install
Homebrew

Mstari mmoja. Imetiwa saini.

2.1
Homebrew tap
brew tap jasonhollis/boogie && brew install jmapcli — faili moja ya binary iliyotiwa saini, hakuna utegemezi wa kukusanya. Maboresho kupitia brew upgrade.
— macOS
Apple silicon
2.2
Uthibitishaji wa Keychain
Vitambulisho husomwa kutoka kwa Keychain ya kuingia ya macOS kwa kitambulisho cha JMAP. Hakuna chochote katika dotfiles, hakuna chochote katika env vars.
— security
find-generic
2.3
Hakuna telemetria
Zana hii haitumi data popote. Mtandao pekee inaogusa ni seva yako ya JMAP.
— zero
SDKs
03.
— Section 3
Credentials
macOS Keychain

Neno lako la siri halifikii diski kamwe.

jmapcli haihifadhi siri yoyote kwenye diski. Neno lako la siri (au tokeni ya bearer) inaishi katika Keychain ya kuingia ya macOS; faili la akaunti — ~/.config/jmapcli/config.json, hali 0600 — huhifadhi tu URL ya seva, jina lako la mtumiaji na bendera ya msingi. Mpya kwenye Keychain kutoka kwa terminal? Mtiririko wote wa kazi ni amri tatu za security zilizojengwa ndani.

1 · Hifadhi siri — na uisomee tena. macOS inakuuliza thamani, kwa hivyo siri haijawahi kuandikwa kwenye mstari wa amri, kuonyeshwa kwenye skrini, au kuandikwa kwenye historia ya shell yako.

# 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
huduma — jina ambalo jmapcli hutafuta: jmap-password kwa neno la siri, au jmap-token kwa tokeni ya bearer (k.m. Fastmail); weka moja tu unayotumia.
-a
akaunti — anwani yako ya barua pepe (jina lile lile la mtumiaji unalotoa kwa jmapcli).
-l
lebo — utakachokiona katika programu ya Keychain Access; -U husasisha kipengee kilichopo mahali pake.
-w
bila thamani — uliza siri. Hii ndiyo sehemu inayoizuia kutoka kwa ~/.zsh_history na orodha ya michakato.

2 · Uelekeze jmapcli kwenye seva yako. Sajili akaunti mara moja; siri huvutwa moja kwa moja kutoka kwa kipengee cha Keychain ulichohifadhi, kwa hivyo haionekani kamwe kwenye mstari wa amri.

$ 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
Hakuna chochote katika historia yako, kumbukumbu — au muktadha wa AI
Mara siri inapokuwa katika Keychain, amri za kila siku (list, send, draft, sync) hazibebei neno la siri, kwa hivyo haiwezi kunaswa katika ~/.zsh_history, orodha ya michakato au kumbukumbu za CI. Hiyo ndiyo inayofanya jmapcli kuwa salama kuendeshwa kutoka kwa zana za terminal-AI — wakala hupewa mteja wa JMAP, si siri yako.
— zsh
CI · agents
3.2
Badilisha au toka
Umebadilisha neno lako la siri? Endesha tena mstari wa security add-generic-password … -w-U huiandika upya mahali pake. Ili kuondoa akaunti, jmapcli logout hufuta ingizo la usanidi na siri ya Keychain katika hatua moja (--all hufuta kila akaunti).
— rotate
logout
3.3
Kwa kila Mac kwa makusudi
Keychain ya kuingia hailandanishwi kupitia iCloud — mpaka uliokusudiwa, ili neno lako la siri lisiwahi kuondoka kwenye Mac ulioliandika. Rudia hatua ya security mara moja kwa kila Mac; config.json inaweza kuwa katika folda ya nyumbani iliyolandanishwa kwa sababu haibeba siri yoyote.
— per
machine
04.
— Section 4
Commands
One verb each

Kila kitu ni amri ndogo.

login
Hifadhi vitambulisho vya seva ya JMAP katika Keychain
discover
Gundua kipindi cha JMAP kutoka kwa seva
accounts
Orodhesha akaunti zilizosanidiwa na kila kitambulisho kinachoweza kutuma
mailboxes
Orodhesha visanduku vyote vya barua
list
Orodhesha barua pepe katika kisanduku cha barua
search
Tafuta barua kwa maandishi, mada, mtumaji, mpokeaji, au mwili (upande wa seva)
read
Onyesha maudhui kamili ya barua pepe (yaliyotolewa kwa Markdown)
send
Tuma barua pepe kupitia JMAP Submission, kutoka kitambulisho chochote kinachoweza kutuma (--from)
reply
Jibu ujumbe kwa ID, ukiunganisha kwenye uzi na kunukuu wa awali
forward
Sambaza ujumbe kwa ID, ukiambatisha tena viambatisho vyake
draft
Hifadhi barua pepe katika Drafts bila kuituma
move · trash · delete
Hamishia kwenye kisanduku cha barua, hamishia kwenye Takataka, au haribu kabisa kwa ID
sync
Fanya usawazishaji wa delta na uonyeshe kilichobadilika
contacts
Anwani za JSContact: orodhesha, ongeza, hariri, ondoa, ingiza lakabu
calendar
Orodhesha kalenda na matukio, andika matukio, weka rangi za kalenda
sieve
Orodhesha, leta, thibitisha na sukuma vichujio vya Sieve vya seva
alias
Simamia lakabu za wapokeaji
mcp
Endesha kama seva ya Model Context Protocol kwa zana za AI
logout
Ondoa vitambulisho vilivyohifadhiwa
05.
— Section 5
Changelog
Every release

Mapya yaliyopo.

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
— Sehemu ya Boogie

Unataka programu kamili?

jmapcli ni bure
programu asilia ya Mail + Kalenda iko kwenye App Store
KTP Digital Pty Ltd · ABN 85 648 755 980