cmddocgen 0.1.0

CmdDocGen - Universal command line help information extraction and man page generation tool powered by LLM for intelligent subcommand analysis

CmdDocGen

Universal Command Line Help Information Extraction and Man Page Generation Tool

Powered by LLM for intelligent subcommand analysis

Overview

CmdDocGen is a universal command line help information extraction tool that can automatically generate standard man page format documentation. It leverages the power of Large Language Models (LLMs) to parse complex help text and supports recursive processing of subcommands.

Key Features

• Universal Support: Works with any command line tool's help documentation
• Standard Format: Automatically generates man page format documentation
• LLM-Powered Analysis: Uses LLM to intelligently parse complex help text
• Recursive Processing: Supports recursive extraction of subcommands
• Multiple LLM Providers: Compatible with various LLM providers
• Performance Optimization: Caching mechanism for improved performance

Installation

From PyPI (Recommended)

pip install cmddocgen

From Source

git clone https://github.com/2niuhe/CmdDocGen.git
cd CmdDocGen
pip install .

Configuration

Environment Variables

CmdDocGen uses environment variables for LLM configuration. Start by copying the example configuration file:

cp .env.example .env

Then edit the .env file with your settings:

# LLM API Base URL
LLM_BASE_URL=https://api.your-llm-provider.com/v1

# LLM API Key
LLM_API_KEY=your-api-key-here

# LLM Model Name
LLM_MODEL=gpt-4o-mini

# LLM Parameters
LLM_TEMPERATURE=0.2
LLM_MAX_TOKENS=8096

Example Configurations

Using AI Proxy

LLM_BASE_URL=https://api.aiproxy.io/v1
LLM_API_KEY=your-aiproxy-api-key
LLM_MODEL=gpt-4o-mini

Using DeepSeek

LLM_BASE_URL=https://api.deepseek.com
LLM_API_KEY=your-deepseek-api-key
LLM_MODEL=deepseek-chat

Usage

Basic Usage

cmddocgen --command "your-command" [--output-dir OUTPUT_DIR]

Examples

# Extract help information for the ls command
cmddocgen ls

# Extract help information for docker command and its subcommands
cmddocgen docker --max-depth 2

# Specify output directory
cmddocgen docker --output-dir "./docs"

Development

1. Clone the repository
2. Copy the configuration file
3. Create a virtual environment
4. Install dependencies

git clone https://github.com/2niuhe/CmdDocGen.git
cd CmdDocGen
cp .env.example .env
python -m venv .venv
source .venv/bin/activate
pip install -e .

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

License

MIT License

Important Notes

• Make sure to properly configure the LLM-related environment variables
• Generated documentation will be saved in the specified output directory
• Cache files are stored in the cache/ directory
• For large command sets with many subcommands, consider limiting the recursion depth