Metadata-Version: 2.4
Name: dwarix-cli
Version: 0.1.0
Summary: Admin CLI for Dwarix, the MCP-native IAM gateway for AI agents
Author: Dwarix
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/imShakil/dwarix
Project-URL: Repository, https://github.com/imShakil/dwarix
Project-URL: Issues, https://github.com/imShakil/dwarix/issues
Project-URL: Changelog, https://github.com/imShakil/dwarix/blob/main/CHANGELOG.md
Keywords: ai-agents,iam,mcp,security,gateway,cli
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Security
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# Dwarix CLI

Admin CLI for [Dwarix](https://github.com/imShakil/dwarix), the MCP-native IAM
gateway for AI agents.

## Install

```bash
pip install dwarix-cli
```

Entrypoints:

```bash
dwarix
dwarix-setup
```

`dwarix-setup` is a legacy alias for setup subcommands.

## Usage

Configure gateway URL and admin key:

```bash
dwarix configure
```

Common commands:

```bash
dwarix agent create --name billing-agent --tags billing,prod
dwarix agent list --json
dwarix token issue <agent_id> --ttl 30
dwarix policy set <agent_id> --allow "stripe/*" --deny "*/delete*" --rate-limit 60
dwarix tools register stripe http://localhost:9001
dwarix logs tail --limit 20 --json
dwarix stats --json
```

By default, the CLI reads:

- `DWARIX_GATEWAY_URL`, default `http://localhost:8080`
- `DWARIX_ADMIN_KEY`, default `dev-admin-key-change-in-production`

`dwarix configure` stores values in `~/.dwarix/config.json`.

## Development

Run from repository root:

```bash
python -m cli.main --help
```

Build package from this directory:

```bash
cd cli
python -m build
python -m twine check dist/*
```

Publish:

```bash
python -m twine upload dist/*
```
