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 --dir to 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

Sponsoring

nlnet

Special thanks to the NLnet foundation and the European Commission that have been financially supporting the project for years:

This program is part of Pimalaya, free software funded entirely by grants and donations. If you find it useful, consider sponsoring its development:

GitHub Ko-fi Buy Me a Coffee Liberapay thanks.dev PayPal