pioneers-cli 0.1.1

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

pioneers-cli

Connect your tools to the AI Pioneers cloud.

The authentication and configuration layer for AI Pioneers cloud features. Connects your local CLI tools (code-explore, code-adapt) to the optional cloud backend via GitHub OAuth.

Quick Start

pip install pioneers-cli

# 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

Commands

Command	Description
pioneers login	Authenticate via GitHub OAuth device flow
pioneers logout	Remove stored credentials
pioneers status	Show current user, plan, and backend setting
pioneers config backend <local|cloud>	Switch between local and cloud mode

Privacy

Your source code never leaves your machine. The cloud backend only stores project metadata — names, languages, dependencies, patterns, and summaries. All analysis and indexing happens locally.

For Tool Authors

Other CLIs can check authentication status programmatically:

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}")

Credentials are stored in ~/.pioneers/credentials.json.

Development

git clone https://github.com/aipioneers/pioneers-cli.git
cd pioneers-cli
pip install -e ".[dev]"
pytest tests/ -v

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT

---

Part of the AI Pioneers ecosystem · code-explore · code-adapt · spec-intelligence