Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 45 additions & 8 deletions .pilot-hints.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,45 @@
PR Pilot is a tool that lets developers delegate small tasks to AI in natural language to save time and avoid context switching.
Every interaction between the user and PR Pilot is a task. Tasks are created using prompts.
This project:
- Uses `click` to implement CLI in Python
- Main entry point is the `pilot` command in `cli/cli.py`
- Sub-commands implemented in `cli/commands/` directory
- Uses `poetry` for dependency management
- Uses `rich` for printing to the console
# PR Pilot CLI Overview

PR Pilot is a command-line interface (CLI) tool designed to help developers delegate routine tasks to AI using natural language. It integrates seamlessly with popular development tools and platforms, allowing users to automate and streamline their workflow.

## Key Features

- **Natural Language Processing**: Interact with the CLI using simple, intuitive commands.
- **Integration with Dev Tools**: Works with tools you already use and trust.
- **Prompt Templates**: Create and execute prompt-based commands using Jinja templates.
- **Reusable Commands**: Save and reuse commands for efficiency.
- **Task Automation**: Automate complex workflows by breaking them into smaller, manageable steps.

## Project Structure

- **CLI Implementation**: Uses `click` to implement the CLI in Python.
- **Main Entry Point**: The `pilot` command is the main entry point, located in `cli/cli.py`.
- **Sub-Commands**: Implemented in the `cli/commands/` directory.
- **Dependency Management**: Utilizes `poetry` for managing dependencies.
- **Console Output**: Uses `rich` for enhanced console output.

## Installation

To install PR Pilot, ensure it is installed in your repository and then use either `pip` or `Homebrew`:

- **pip**: `pip install --upgrade pr-pilot-cli`
- **Homebrew**: `brew tap pr-pilot-ai/homebrew-tap` and `brew install pr-pilot-cli`

## Usage

- **Basic Command**: `pilot task "Describe the project!"`
- **Edit Files**: `pilot edit cli/cli.py "Add docstrings to all functions."`
- **Generate Code**: `pilot task -o test_utils.py --code "Write unit tests for utils.py."`
- **Organize Issues**: `pilot task "Categorize open Github issues labeled 'bug'."`

## Configuration

Configuration is managed via `~/.pr-pilot.yaml`, where you can set your API key, default repository, and other preferences.

## Contribution

Contributions are welcome! Feel free to submit pull requests or report issues on the GitHub repository.

## License

PR Pilot CLI is open-source software licensed under the GPL-3 license.