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

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