Pimalaya CLI [](https://docs.rs/pimalaya-cli/latest/pimalaya_cli) [](https://matrix.to/#/#pimalaya:matrix.org) [](https://fosstodon.org/@pimalaya) [](https://pimalaya.org/sponsor/)
August 24, 2026 · View on GitHub
CLI utils for Pimalaya
Shared building blocks for the Pimalaya command-line tools: the pieces every CLI would otherwise reimplement, factored out behind cargo features so each binary pulls in only what it uses. Unlike the io-* protocol libraries this crate is deliberately std, since it exists to talk to a terminal, a filesystem and a human.
Table of contents
Features
- Argument parsing glue: shared clap arguments and the ready-made completion, manual page and JSON Schema generation commands, so every binary exposes them the same way: a positional list selecting what to generate, an optional
--dirto write files in, and the standard output otherwise. - Output rendering: a printer that writes command output and a reporter that writes failures, both to stdout, with optional JSON output and formatted tables.
- Logging: a logger initialized from a shared verbosity flag.
- Interactive input: text and password prompts, reusable value validators, and a cancellable spinner for long-running work.
- Account wizards: guided collection of account settings per protocol, IMAP, SMTP, JMAP, CalDAV and CardDAV, each behind its matching feature.
- Build helpers: small utilities for build scripts, such as feature and git metadata.
Tip
Pimalaya CLI is written in Rust and uses cargo features to gate each tool. The default feature set is declared in Cargo.toml or on docs.rs.
Usage
See documentation at docs.rs.
Examples
See complete examples at ./examples.
License
This project is licensed under either of:
Social
- Chat on Matrix
- News on Mastodon or RSS
- Mail at pimalaya.org@posteo.net
Sponsoring
Special thanks to the NLnet foundation and the European Commission that have been financially supporting the project for years:
- 2022 → 2023: NGI Assure
- 2023 → 2024: NGI Zero Entrust
- 2024 → 2026: NGI Zero Core
- 2026 → 2027: NGI Zero Commons Fund
This program is part of Pimalaya, free software funded entirely by grants and donations. If you find it useful, consider sponsoring its development:
