Metadata-Version: 2.1
Name: droid-please
Version: 0.0.3
Summary: Simple cli for genai project management
Author: Luke Lalor
Author-email: lukehlalor@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: anthropic (>=0.42.0,<0.43.0)
Requires-Dist: jsonref (>=1.1.0,<2.0.0)
Requires-Dist: jsonschema (>=4.23.0,<5.0.0)
Requires-Dist: pydantic (>=2.10.4,<3.0.0)
Requires-Dist: python-dotenv (>=1.0.1,<2.0.0)
Requires-Dist: pyyaml (>=6.0.2,<7.0.0)
Requires-Dist: rich (>=13.9.4,<14.0.0)
Requires-Dist: typer (>=0.15.1,<0.16.0)
Description-Content-Type: text/markdown

# Droid Please

A simple CLI tool that acts as your AI coding assistant. It helps you manage your project through natural language commands, allowing you to perform various file operations and coding tasks by simply asking.


## Why "Droid Please"?

There are lots of code assistants and IDEs out there. Why is _droid-please_ different?

LLM IDEs and other tools tend to live with the developer. This means they cannot specialize in a project. They need to 
either be told explicitly by the dev the context for the problem, or at best use RAG to dynamically grab the context.

The impetus for _droid-please_ is that these resources should live alongside and be versioned with the project code like your .git 
directory. The idea here being that LLMs are expensive, especially if we want to create agents that learn about a 
project. Furthermore, this learning needs to change over time as the project evolves. There is no reason for each dev to
waste time and resources teaching their own personal llm about a shared codebase. Moreover, when I pull in a change. I 
would like my coding assistant to already know about those changes.

This improves performance, but it is also a more cost-effective model for a GenAI tool. It allows for 
"expensive" project learning since it only needs to happen occasionally per project rather than on every completion.

### Approach
Currently, `droid learn` is a basic process that automatically "learns" by allowing the agent to read through the project file system 
and save a project summary file that is injected into the `droid please` system prompt.

When using `droid please` the agent has access to the project summary and tools to manipulate the file system.

## Pre-requisites
### Robust Version Control
Before we get into this project at all, you should have a robust version control system in place. This project is about 
letting AI Agents manage your projects, which means droid can modify files within your project. Eventually **🚨 Droid 
will break something 🚨**, and when this happens the ability to revert those changes is paramount.

### Python 3.10
This project requires Python 3.10 or higher. You can download the latest version of Python from the [official website](https://www.python.org/downloads/).

### PIP
The Quickstart guide uses pip. You can install pip by following the instructions [here](https://pip.pypa.io/en/stable/installation/).

### Anthropic API Key
This project right now only runs with Anthropic. Get an API key from [Anthropic](https://www.anthropic.com/)

## Quick Start

### Installation
```bash
pip install droid-please --upgrade
```
This will install the `droid` CLI tool on your system. Let's make sure it's installed correctly by running.
```bash
droid --help
```

```
╭─ Commands ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ init       Initialize a new .droid directory in the current directory with required configuration files.                                                                                          │
│ learn      Analyze the project structure and learn about its organization and purpose. The summary will be saved to the config file for future reference.                                         │
│ please     Ask the droid to do something.                                                                                                                                                         │
│ continue   Continue a conversation with the droid. If no conversation file is provided, continues the most recent conversation.                                                                   │
│ save       Save a version of the latest conversation. If no conversation file is provided, saves the most recent conversation.                                                                    │
╰───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
```

> 🚨 You might need reset or restart your terminal to get the `droid` command to work.

Droid please also contains (optional) completions.:
```bash
droid --install-completion
```

### Initialize droid in your project
The first thing we need to do is initialize `droid` in your project. This creates a `.droid` directory with project-specific settings and helps the AI understand your project structure.
```bash
cd /path/to/your/git/project
droid init
```
```
Anthropic API key (optional): *****
Initialized project: /path/to/your/git/project/.droid
```
> If you don't have your API key set up yet, you will be prompted to set it up.

### Have droid learn about your project
```bash
droid learn
```

### Try it out!
```bash
driod please "Update (or create) my project's readme" -i
```
> The `-i` flag is for interactive mode. This will allow you to continue a conversation with your agent without having to run additional commands.


## Contributing

Droid Please!

### Need Help?

- Open an issue for questions or problems

Thank you for taking a look at Droid Please! 🚀

