Metadata-Version: 2.4
Name: clue2app-cli
Version: 0.2.7
Summary: CLI application for clue2app using the clue2app-python-sdk
Home-page: https://github.com/clue2solve/clue2app-cli
Author: Clue2App CLI Team
Author-email: Clue2App CLI Team <support@clue2app.com>
License: MIT
Project-URL: Homepage, https://github.com/clue2solve/clue2app-cli
Project-URL: Documentation, https://docs.clue2app.com/cli
Project-URL: Repository, https://github.com/clue2solve/clue2app-cli
Project-URL: Issues, https://github.com/clue2solve/clue2app-cli/issues
Keywords: cli,clue2app,sdk
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0.0
Requires-Dist: requests>=2.28.0
Requires-Dist: rich>=12.0.0
Requires-Dist: keyring>=23.0.0
Requires-Dist: pydantic>=1.10.0
Requires-Dist: toml>=0.10.0
Requires-Dist: questionary>=2.0.0
Requires-Dist: textual>=0.40.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=22.0.0; extra == "dev"
Requires-Dist: isort>=5.10.0; extra == "dev"
Requires-Dist: flake8>=5.0.0; extra == "dev"
Requires-Dist: mypy>=0.991; extra == "dev"
Requires-Dist: pandas>=1.5.0; extra == "dev"
Provides-Extra: build
Requires-Dist: pyinstaller>=6.0.0; extra == "build"
Requires-Dist: invoke>=2.0.0; extra == "build"
Requires-Dist: tox>=4.0.0; extra == "build"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Clue2App CLI

**Command-line interface for the Clue2App platform**

[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Tests](https://img.shields.io/github/actions/workflow/status/clue2solve/clue2app-cli/tests.yml?label=tests)](https://github.com/clue2solve/clue2app-cli/actions/workflows/tests.yml)
[![Release](https://img.shields.io/github/v/release/clue2solve/clue2app-cli)](https://github.com/clue2solve/clue2app-cli/releases)

## Installation

### Option 1: pip (Recommended)

```bash
pip install clue2app-cli
```

### Option 2: Standalone Executable

Download from [Releases](https://github.com/clue2solve/clue2app-cli/releases):

```bash
# macOS (Apple Silicon)
curl -L https://github.com/clue2solve/clue2app-cli/releases/latest/download/clue2app-macos-arm64 -o c2a
chmod +x c2a && sudo mv c2a /usr/local/bin/

# macOS (Intel)
curl -L https://github.com/clue2solve/clue2app-cli/releases/latest/download/clue2app-macos-x64 -o c2a
chmod +x c2a && sudo mv c2a /usr/local/bin/

# Linux
curl -L https://github.com/clue2solve/clue2app-cli/releases/latest/download/clue2app-linux-x64 -o c2a
chmod +x c2a && sudo mv c2a /usr/local/bin/
```

## Quick Start

```bash
# Login to your account
c2a login

# Check status
c2a status

# List your projects
c2a project list

# Select a project
c2a project use MyProject

# List apps in current project
c2a app list

# Deploy an app from GitHub
c2a app create my-app --git-url https://github.com/user/repo

# View app logs
c2a logs show my-app

# Rebuild an app
c2a rebuild my-app
```

## Key Commands

| Command | Description |
|---------|-------------|
| `c2a login` | Authenticate with Clue2App |
| `c2a status` | Show CLI and auth status |
| `c2a project list` | List all projects |
| `c2a project use <name>` | Set active project |
| `c2a app list` | List apps in current project |
| `c2a app create <name> --git-url <url>` | Deploy a new app from a Git repo |
| `c2a logs show <app>` | View application logs (`--build` for build logs, `-f` to follow) |
| `c2a build logs <app>` | View latest build logs for an app |
| `c2a rebuild <app>` | Trigger app rebuild |
| `c2a env set <app> KEY=value` | Set environment variables |
| `c2a secrets create -n <name> -u <user> -p <token>` | Create a git credential secret |
| `c2a llm list` / `c2a llm create` / `c2a llm bind <app> <secret>` | Manage LLM Gateway bindings (see [Daari LLM](docs/daari-llm.md)) |
| `c2a daari secrets list` / `bind <app> <secret>` | Manage Daari service bindings (see [Daari](docs/daari.md)) |

## Configuration

Config files are stored in `~/.c2a/`:
- `config.toml` - CLI settings
- `credentials.json` - Authentication tokens

Override the API base URL (or any other config key) with `c2a config set`:
```bash
c2a config set api.base_url https://custom-api.example.com
```

## Documentation

For complete documentation, guides, and tutorials:

**[https://clue2app.ai/docs](https://clue2app.ai/docs)**

- [Quick Start Guide](https://clue2app.ai/docs/quick-start)
- [CLI Reference](https://clue2app.ai/docs/cli-reference)
- [MCP Server Setup](https://clue2app.ai/docs/mcp-quickstart)
- [Deployment Guide](https://clue2app.ai/docs/deployment-journey)

## Agents

Clue2App includes specialized agents that help manage your applications:

| Agent | Purpose |
|-------|---------|
| **Deployment** | Deploy, rebuild, and manage application lifecycle |
| **Cleanup** | Remove orphaned resources and maintain clean infrastructure |
| **System Health** | Detect anomalies and report system issues |
| **Audit** | Track all operations with full audit trail and rollback support |

Each agent has a single responsibility and they work together to keep your platform healthy.

## MCP Server Integration

Use Clue2App with AI assistants (Claude Code, Cursor, Claude Desktop):

```bash
pip install clue2app-mcp
```

See [MCP Quick Start](https://clue2app.ai/docs/mcp-quickstart) for setup instructions.

## Development

```bash
# Clone and install in dev mode
git clone https://github.com/clue2solve/clue2app-cli.git
cd clue2app-cli
pip install -e ".[dev]"

# Run tests
pytest

# Build executable
pip install -e ".[build]"
make build
```

## Support

- **Documentation**: [clue2app.ai/docs](https://clue2app.ai/docs)
- **Issues**: [GitHub Issues](https://github.com/clue2solve/clue2app-cli/issues)

## License

MIT License - see [LICENSE](LICENSE) for details.
