Clue2App CLI

Command-line interface for the Clue2App platform

Install

pip install clue2app-cli

Requires Python 3.10+. Verify with c2a --version.

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

Inviting a project member (SCK-625)

Pass -A <account_uuid> to route through the invitations service (POST /api/v1/invitations/project-member, backed by SCK-622). The new endpoint mints an invitation row, sends the redemption email by default, and returns a redemption URL the CLI prints:

# Server sends the invitation email (default delivery).
c2a user invite -e alice@corp.com -A <account_uuid> -P <project_uuid> -r CONTRIBUTOR

# --copy-only skips the email; hand-deliver the printed URL yourself.
c2a user invite -e alice@corp.com -A <account_uuid> -P <project_uuid> -r VIEWER --copy-only

-r accepts VIEWER, CONTRIBUTOR, or PROJECT_ADMIN. Without -A, c2a user invite keeps its legacy behaviour (invite-with- project-grants via /api/accounts/{id}/members, or the LOCAL user create flow with -u/-p).

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.