Metadata-Version: 2.3
Name: anti-cursor
Version: 1.0.0
Summary: A CLI utility to generate prompts from project source code.
Author: Alexander-Ploskin
Author-email: ploskin0107@gmail.com
Requires-Python: >=3.12,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: click (>=8.1.8,<9.0.0)
Requires-Dist: gitignore-parser (>=0.1.11,<0.2.0)
Requires-Dist: pyperclip (>=1.9.0,<2.0.0)
Description-Content-Type: text/markdown

# Anti-Cursor

A Python CLI utility to generate a Markdown prompt describing a project's source code structure and contents. The generated prompt includes an introductory explanation, a detailed projection of the file structure, and code listings from each source file (with file names).

## Features

- Accepts either a local directory path or a GitHub repository URL.
- Generates a Markdown prompt with:
  - A brief introduction to assist language models in understanding the context.
  - A detailed project structure tree.
  - Code listings from individual source files.
- Clean architecture with clear separation between CLI, core logic, and file parsing.
- Unit tests to ensure proper functionality.


## Installation

### From sources

1. **Clone the repository:**
```bash
git clone https://github.com/Alexander-Ploskin/anti-cursor.git
```

2. **Install the dependencies:**
```bash
sudo apt-get install xclip
pip install poetry
poetry install
```

### From package
```bash
pip install anti-cursor
```

## Usage

Run the CLI tool using:
```bash
anti-cursor <source>
```
Where `<source>` is either a local directory path or a GitHub repository URL.

**Examples:**
1. Generate prompt from local directory:
```bash
anti-cursor .
```
2. Generate prompt from GitHub repository:
```bash
anti-cursor https://github.com/Alexander-Ploskin/anti-cursor
```

