agenzic 0.1.0

AI-powered CLI assistant for developers: commits, summaries, PR reviews, docs.

Agenzic

Agenzic is a terminal-based AI assistant for developers. It streamlines developer workflows by providing AI-powered commit messages, code/file summarization, pull request reviews, documentation generation, and unit test suggestions — all from the command line.

---

Features

• AI Commit Assistant Generate clean, conventional commit messages from staged Git changes. Supports multiple options and allows editing before committing.

• Code/File Summarizer Summarize files or entire codebases to quickly understand legacy code or onboard new developers.

• AI PR / Code Reviewer Review staged Git changes or specific code files. Provides suggestions for security, style, and possible bugs.

• Documentation Generator Generate docstrings or README drafts for individual files or entire projects.

• Test Case Generator Suggest unit tests for your functions based on code content.

• Version & Environment Info Quickly display the current version of Agenzic along with relevant environment information.

• Help & Usage Guidance Built-in help command provides a concise overview of commands and usage examples.

---

Installation

pip install agenzic

Note: Agenzic requires an OpenAI API key. Set it as an environment variable:

export OPENAI_API_KEY="your_api_key_here"

Or, if using a .env file:

OPENAI_API_KEY=your_api_key_here

---

Usage

# Generate AI commit messages for staged changes
agenzic commit

# Summarize a file
agenzic summarize myscript.py

# Review staged changes or a specific file
agenzic review
agenzic review --file utils/helpers.py

# Generate documentation
agenzic docgen --file myscript.py
agenzic docgen --dir src/

# Generate unit tests for a file
agenzic tests myscript.py

# Show version and environment info
agenzic version

# Show project information
agenzic about

# Display help
agenzic help

---

Project Structure

agenzic/
├── agenzic/                # Python package
│   ├── __init__.py
│   ├── __main__.py         # CLI entrypoint
│   ├── commands/           # Individual commands (commit, summarize, review, etc.)
│   └── utils/              # Utility functions (API key, helpers)
├── pyproject.toml           # Project configuration
├── README.md               # This file
└── LICENSE                 # License file

---

License

Agenzic is licensed under the MIT License.

---

Contributing

Contributions are welcome!

• Fork the repository
• Create a feature branch (git checkout -b feature/my-feature)
• Commit your changes (git commit -am 'Add feature')
• Push to the branch (git push origin feature/my-feature)
• Open a Pull Request

---