Pimalaya CLI

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
• Usage
• Examples
• AI policy
• License
• Social
• Contributing
• Sponsoring

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, as JSON or as plain text: records as aligned Label: value lines, lists as borderless aligned columns, wide lists as git log-style records, untrusted strings defused.
• Logging: a logger initialized from a shared verbosity flag.
• Interactive input: text, confirmation and choice prompts, and a cancellable spinner for long-running work.
• Sessions: a read-eval-print loop running the binary's own commands over stdin, and a Model Context Protocol server over stdio whose tools may take their input from the clap grammar, both holding one account open across commands.
• 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:

• MIT license
• Apache License, Version 2.0

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: