Metadata-Version: 2.4
Name: arxiv-cli-tools
Version: 0.1.0
Summary: Command-line interface for searching and downloading arXiv papers.
Author: Marc Kotrotsos
Keywords: arxiv,cli,search,papers
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: arxiv>=2.2.0
Requires-Dist: requests>=2.31

# arxiv-cli-tools

Command-line interface for searching and downloading arXiv papers, built on top of the [arxiv](https://pypi.org/project/arxiv/) Python client.

## Installation

```bash
pip install arxiv-cli-tools
```

To work from source instead, clone the repository and install in editable mode:

```bash
pip install -e .
```

## Usage

Inspect the available commands and options:

```bash
arxiv-cli --help
arxiv-cli search --help
arxiv-cli download --help
```

Typical commands:

```bash
# Search the API and show abstracts
arxiv-cli search "prompt engineering" -n 5 --summary

# Fetch specific papers by identifier into a folder
arxiv-cli download --id 2101.01234 --id 2105.06789 --dest papers --skip-existing
```

The CLI mirrors the underlying arXiv API, adding convenience flags for authors, categories, result limits, and download preferences. See the built-in help for the full reference.
