Metadata-Version: 2.4
Name: terrascout
Version: 0.7.0
Summary: Terrascout CLI — geospatial data scoping from the terminal
Project-URL: Homepage, https://terrascout.app
Project-URL: Documentation, https://terrascout.app/integrations
Project-URL: Release Notes, https://terrascout.app/integrations
Project-URL: Support, https://terrascout.app/integrations
Author-email: Mazdak Ghasemi Tootkaboni <maz@terrascout.dev>
License: Proprietary
Keywords: cli,earth-observation,geospatial,remote-sensing,satellite,terrascout
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0
Requires-Dist: typer>=0.12
Provides-Extra: eodag
Requires-Dist: eodag>=3.0; extra == 'eodag'
Description-Content-Type: text/markdown

# Terrascout CLI

Geospatial data scoping from the terminal. Find the best satellite imagery and spatial datasets for your project — ranked, scored, and assessed for feasibility.

Powered by [Terrascout](https://terrascout.app).

## Install

```bash
pip install terrascout
```

Requires Python 3.11+. No API key needed for free-tier features.

## Quick Start

```bash
# Check connectivity to Terrascout API
terrascout health

# Create a scope from a natural language brief
terrascout scope new "Monitor vegetation on a 500ha mine site near Emerald QLD, monthly for 12 months"

# View results for a scope
terrascout scope view <scope_id>

# Download a PDF compliance report
terrascout scope report <scope_id> --output report.pdf

# Compare recommendations side-by-side
terrascout scope compare <scope_id>
```

## Search

```bash
# Browse free satellite data providers
terrascout search providers --free-only

# Filter by resolution
terrascout search providers --resolution 10

# Search STAC catalogs for recent scenes
terrascout search stac --collection sentinel-2-l2a --bbox 144,-38,145,-37
```

## Projects

```bash
# List your project workspaces
terrascout project list

# Create a new project
terrascout project create "Mine Rehabilitation Monitoring"
```

## AI Agents

```bash
# List available AI agents
terrascout agents list

# Run an agent on a scope
terrascout agents run methodology_writer --scope <scope_id>
```

## Configuration

Config is stored at `~/.terrascout/config.yaml`:

```bash
# View current config
terrascout config show

# Point to a different API (e.g., local dev server)
terrascout config set api_url http://localhost:8000

# Point to production (default)
terrascout config set api_url https://terrascout.app
```

## Authentication

```bash
terrascout auth login --email user@example.com
terrascout auth status
terrascout auth logout
```

Authentication is optional for core scoping features. Required for projects, agents, and alert subscriptions.

## Also Available

- **Web app**: [https://terrascout.app](https://terrascout.app)
- **MCP Server**: Connect Terrascout to Claude, Cursor, Windsurf, and other AI assistants
- **REST API**: Full OpenAPI docs at [/docs](https://terrascout.app/docs)
