Metadata-Version: 2.4
Name: scopeform
Version: 0.1.1
Summary: Identity and access management for AI agents
Project-URL: Homepage, https://scopeform-web.vercel.app
Project-URL: Repository, https://github.com/emartai/scopeform
Project-URL: Documentation, https://scopeform-web.vercel.app
Author: Scopeform
License: MIT
Keywords: agents,ai,cli,iam,scopeform,security
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: httpx==0.28.1
Requires-Dist: pydantic==2.7.1
Requires-Dist: pyyaml==6.0.2
Requires-Dist: rich==13.9.4
Requires-Dist: typer[all]==0.15.2
Provides-Extra: dev
Requires-Dist: pytest-asyncio==0.25.3; extra == 'dev'
Requires-Dist: pytest==8.3.5; extra == 'dev'
Requires-Dist: respx==0.22.0; extra == 'dev'
Description-Content-Type: text/markdown

# Scopeform CLI

Identity and access management for AI agents.

## Installation

```bash
pip install scopeform
```

## Quickstart

1. Log in:

```bash
scopeform login
```

2. Initialize your agent project:

```bash
scopeform init
```

3. Register the agent and issue a scoped token:

```bash
scopeform deploy
```

4. Use `SCOPEFORM_TOKEN` in your agent runtime environment.

5. Revoke active sessions when needed:

```bash
scopeform revoke <agent-name>
```

## Commands

### `scopeform login`

Sign in with your email and password. Stores your auth token in `~/.scopeform/config.json`.

Flags:

- `--api-url TEXT` Override the Scopeform API base URL.

### `scopeform init`

Create a `scopeform.yml` file for the current project using interactive prompts.

### `scopeform deploy`

Register the current project as an agent and write `SCOPEFORM_TOKEN` to `.env`.

Flags:

- `--api-url TEXT` Override the Scopeform API base URL.

### `scopeform revoke <agent-name>`

Revoke all active tokens for the named agent.

Flags:

- `--api-url TEXT` Override the Scopeform API base URL.

### `scopeform logs <agent-name>`

Show recent logs for the named agent.

Flags:

- `--limit INTEGER` Maximum number of log entries to show. Default: `20`
- `--service TEXT` Filter by service
- `--blocked-only` Show only blocked calls
- `--api-url TEXT` Override the Scopeform API base URL.

### Global flags

- `--api-url TEXT` Default: `SCOPEFORM_API_URL` or `https://api.scopeform.dev`
- `--version` Show the installed package version
