Metadata-Version: 2.4
Name: pioneers-cli
Version: 0.1.0
Summary: CLI for AI Pioneers cloud — authenticate, configure, and connect your tools.
Author: Tobias Oberrauch
License-Expression: MIT
Keywords: cli,cloud,developer-tools,pioneers
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Requires-Dist: httpx>=0.24.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.9.0
Provides-Extra: dev
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# pioneers-cli

CLI for AI Pioneers cloud — authenticate, configure, and connect your tools.

## Install

```bash
pip install pioneers-cli
```

## Usage

```bash
# Authenticate via GitHub
pioneers login

# Check status
pioneers status

# Enable cloud backend for code-explore / code-adapt
pioneers config backend cloud

# Switch back to local
pioneers config backend local

# Log out
pioneers logout
```

## What It Does

`pioneers-cli` is the authentication and configuration layer for [AI Pioneers](https://pioneers.ai) cloud features. It connects your local CLI tools (code-explore, code-adapt) to the optional cloud backend.

- **Login** — GitHub OAuth device flow, stores token in `~/.pioneers/credentials.json`
- **Config** — Switch between `local` and `cloud` backend
- **Status** — Show current user, plan, and backend setting

Your source code never leaves your machine. The cloud only stores project metadata (name, languages, dependencies, patterns, summaries).

## For Tool Authors

Other CLIs can check authentication status:

```python
from pioneers_cli.config import load_credentials, load_config

creds = load_credentials()
if creds:
    print(f"Logged in as {creds.username}")

config = load_config()
if config.backend == "cloud":
    print(f"Using cloud API at {config.api_url}")
```

## License

MIT
