Metadata-Version: 2.3
Name: xenfra
Version: 0.4.5
Summary: Xenfra CLI: Hands for AI to deploy on DigitalOcean.
Author: xenfra-cloud
Author-email: xenfra-cloud <xenfracloud@gmail.com>
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: System :: Systems Administration
Requires-Dist: click>=8.1.7
Requires-Dist: rich>=14.2.0
Requires-Dist: sqlmodel>=0.0.16
Requires-Dist: python-digitalocean>=1.17.0
Requires-Dist: python-dotenv>=1.2.1
Requires-Dist: pyyaml>=6.0.1
Requires-Dist: fabric>=3.2.2
Requires-Dist: xenfra-sdk>=0.2.2
Requires-Dist: httpx>=0.27.0
Requires-Dist: keyring>=25.7.0
Requires-Dist: keyrings-alt>=5.0.2
Requires-Dist: tenacity>=8.2.3
Requires-Dist: cryptography>=43.0.0
Requires-Dist: toml>=0.10.2
Requires-Dist: pytest>=8.0.0 ; extra == 'test'
Requires-Dist: pytest-mock>=3.12.0 ; extra == 'test'
Requires-Python: >=3.11
Project-URL: Homepage, https://github.com/xenfra-cloud/xenfra-cli
Project-URL: Issues, https://github.com/xenfra-cloud/xenfra-cli/issues
Provides-Extra: test
Description-Content-Type: text/markdown

# Xenfra CLI (The Interface) 🖥️

[![PyPI](https://img.shields.io/pypi/v/xenfra)](https://pypi.org/project/xenfra/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

The official command-line interface for **Xenfra** (The Sovereign Cloud OS). It empowers developers to deploy, monitor, and manage applications on their own infrastructure (DigitalOcean) with the ease of Heroku.

## 🚀 Features

- **Zero-Config Deployment**: `xenfra deploy` detects your stack (Python, Node.js) and ships it.
- **Sovereign Auth**: `xenfra auth login` connects securely to your cloud provider.
- **Live Logs**: `xenfra logs` streams colorized, PII-scrubbed logs from your servers.
- **Doctor**: `xenfra doctor` runs a battery of health checks on your deployment environment.
- **Zen Mode**: Automatically applies fix patches when deployments fail.

## 📦 Installation

```bash
# Recommended: Install via uv
uv tool install xenfra

# Or via pip
pip install xenfra
```

## 🛠️ Quick Start

### 1. Login

Authenticate with your cloud provider (DigitalOcean via Xenfra Platform).

```bash
xenfra auth login
```

### 2. Deploy Your App

Navigate to your project directory and blast off.

```bash
cd ~/my-projects/awesome-api
xenfra deploy
```

_That's it._ Xenfra handles Dockerfile generation, server provisioning, SSL (Caddy), and database connections.

### 3. Check Status

```bash
xenfra status
```

## 🎛️ Command Reference

| Command             | Description                             |
| :------------------ | :-------------------------------------- |
| `xenfra auth login` | Start the OAuth flow                    |
| `xenfra deploy`     | Deploy current directory                |
| `xenfra logs`       | Tail logs (Ctrl+C to stop)              |
| `xenfra status`     | Show health metrics (CPU/RAM)           |
| `xenfra list`       | List all your projects                  |
| `xenfra init`       | Generate config files without deploying |

## 🔗 The Xenfra Ecosystem

This CLI is the "Interface" of the Xenfra Open Core architecture:

- **[xenfra-sdk](https://github.com/xenfracloud/xenfra-sdk)**: The Core Engine (Used by this CLI).
- **[xenfra-mcp](https://github.com/xenfracloud/xenfra-mcp)**: The AI Agent Interface.
- **xenfra-platform**: The Private SaaS Backend.

## 🤝 Contributing

We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.

## 📄 License

MIT © [Xenfra Cloud](https://xenfra.tech)
