AgentManu

(AI) Agent Manual Helper for Unix Commands

AgentManu is a minimalist yet powerful AI assistant that explains Unix commands in human-friendly terms.
Similar to tldr but smarter and more flexible.

Powered by Google Gemini 2.5 (easily swappable for other models).

The AI model will be selected based on the available API keys in the .env file. (Providers: Groq, Celebra, Google Gemini)

Video

Features

• Faster than man pages
• More flexible than tldr (with AI context awareness)
• Multi-language support (change output language on demand)
• Bash wrapper (¿) for quick queries
• Lightweight

Requirements

It use uv as project manager.

The model will be selected based on the available API keys in the .env file. In order Groq > Celebra > Google Gemini. Add a .env file in the same folder with your API key:

GROQ_API_KEY="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
# or
CELEBRAS_API_KEY="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
# or
GOOGLE_API_KEY="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Installation

Clone the repository:

git clone git@github.com:uberkael/AgentManu.git

Usage

Launch with uv:

uv run main.py <COMMAND and ARGS>

The output language can be changed using -l, -lang, -i, --idiom, --language

uv run main.py <COMMAND and ARGS>

It provides a bash wrapper command ¿ for asking about commands.
(Due problems with the ? character in bash, the wrapper was changed to ¿)

# Make the bash wrapper executable
chmod +x "¿"

Launch with ?:

¿ ls -l
¿ ps aux | grep
¿ watch 'ps aux | rg code'
...

Example Output

Different languages, it can accept any (depends on the LLM).

More examples: