Metadata-Version: 2.4
Name: precogs-cli
Version: 0.1.0
Summary: Command-line interface for Precogs AI security platform
Project-URL: Homepage, https://precogs.ai
Project-URL: Documentation, https://docs.precogs.ai/cli
Project-URL: Repository, https://github.com/precogsai/precogs-cli
Author-email: Precogs AI <support@precogs.ai>
License-Expression: MIT
License-File: LICENSE
Keywords: cli,code-analysis,devsecops,security,vulnerability
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
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: Programming Language :: Python :: 3.12
Classifier: Topic :: Security
Requires-Python: >=3.8
Requires-Dist: precogs-sdk>=0.1.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.9.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# Precogs CLI

Command-line interface for the [Precogs AI](https://precogs.ai) security platform.

## Installation

```bash
pip install precogs-cli
```

## Quick Start

```bash
# Authenticate with your API key
precogs auth login

# List your projects
precogs projects list

# Trigger a code scan
precogs scan code <project-id>

# View vulnerabilities
precogs vulns list --severity critical

# Get AI-generated fix
precogs vulns fix <vuln-id>
```

## Commands

### Authentication

```bash
# Login with API key
precogs auth login
precogs auth login --api-key pk_live_xxx

# Check auth status
precogs auth status

# Logout
precogs auth logout
```

### Projects

```bash
# List all projects
precogs projects list

# Get project details
precogs projects get <project-id>
```

### Scanning

```bash
# Code security scan (SAST)
precogs scan code <project-id>
precogs scan code <project-id> --branch develop

# Dependency scan (SCA)
precogs scan dependency <project-id>

# Infrastructure as Code scan
precogs scan iac <project-id>

# Container image scan
precogs scan container <project-id> nginx:latest
```

### Vulnerabilities

```bash
# List vulnerabilities
precogs vulns list
precogs vulns list --project <id> --severity high

# Get vulnerability details
precogs vulns get <vuln-id>

# Get AI-generated fix
precogs vulns fix <vuln-id>
```

### Dashboard

```bash
# Show security overview
precogs dashboard
precogs dashboard --project <id>
```

## Configuration

API key is stored in `~/.precogs/config.json`

You can also set the `PRECOGS_API_KEY` environment variable:

```bash
export PRECOGS_API_KEY=pk_live_xxx
```

## License

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