README.md

Precogs CLI

Command-line interface for the Precogs AI security platform.

Installation

pip install precogs-cli

Quick Start

# 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

# 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

# List all projects
precogs projects list

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

Scanning

# 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

# 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

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

export PRECOGS_API_KEY=pk_live_xxx

License

MIT License - see LICENSE for details.