Clue2App CLI

Command-line interface for the Clue2App platform

Installation

Option 1: pip (Recommended)

pip install clue2app-cli

Option 2: Standalone Executable

Download from Releases:

# 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

# 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

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:

c2a config set api.base_url https://custom-api.example.com

Documentation

For complete documentation, guides, and tutorials:

https://clue2app.ai/docs

• Quick Start Guide
• CLI Reference
• MCP Server Setup
• Deployment Guide

Agents

Clue2App includes specialized agents that help manage your applications:

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):

pip install clue2app-mcp

See MCP Quick Start for setup instructions.

Development

# 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
• Issues: GitHub Issues

License

MIT License - see LICENSE for details.