Metadata-Version: 2.4
Name: trinity-cli
Version: 0.2.4
Summary: CLI for the Trinity Autonomous Agent Orchestration Platform
Author-email: Ability AI <hello@ability.ai>
License-Expression: MIT
Project-URL: Homepage, https://github.com/abilityai/trinity
Project-URL: Documentation, https://github.com/abilityai/trinity/blob/main/docs/CLI.md
Project-URL: Repository, https://github.com/abilityai/trinity
Project-URL: Issues, https://github.com/abilityai/trinity/issues
Keywords: trinity,ai,agents,orchestration,cli
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0
Requires-Dist: httpx>=0.24
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0

# Trinity CLI

Command-line interface for the [Trinity](https://github.com/abilityai/trinity) Autonomous Agent Orchestration Platform.

## Install

```bash
# With pip
pip install trinity-cli

# With pipx (recommended — isolated environment)
pipx install trinity-cli
```

## Quick Start

```bash
# Connect to your Trinity instance
trinity init

# List your agents
trinity agents list

# Chat with an agent
trinity chat my-agent "Hello, what can you do?"

# Check fleet health
trinity health fleet
```

## Multi-Instance Profiles

Manage multiple Trinity instances (local dev, staging, production):

```bash
# First instance (created during init)
trinity init

# Add another instance
trinity init --profile production

# Switch between instances
trinity profile use production
trinity profile list
```

## Commands

| Command | Description |
|---------|-------------|
| `trinity init` | Connect to a Trinity instance |
| `trinity login` | Re-authenticate with stored instance |
| `trinity agents list` | List all agents |
| `trinity agents create <name>` | Create a new agent |
| `trinity agents start <name>` | Start an agent |
| `trinity agents stop <name>` | Stop an agent |
| `trinity chat <agent> "msg"` | Chat with an agent |
| `trinity history <agent>` | View chat history |
| `trinity logs <agent>` | View agent logs |
| `trinity health fleet` | Fleet health overview |
| `trinity health agent <name>` | Single agent health |
| `trinity skills list` | Browse skill library |
| `trinity schedules list <agent>` | View agent schedules |
| `trinity profile list` | List configured profiles |
| `trinity profile use <name>` | Switch active profile |

## Output Formats

```bash
# Table (default, human-readable)
trinity agents list

# JSON (for piping/scripting)
trinity agents list --format json
```

## Environment Variables

| Variable | Description |
|----------|-------------|
| `TRINITY_URL` | Override instance URL |
| `TRINITY_API_KEY` | Override auth token |
| `TRINITY_PROFILE` | Override active profile |

## Documentation

- [Full CLI docs](https://github.com/abilityai/trinity/blob/main/docs/CLI.md)
- [Trinity Platform](https://github.com/abilityai/trinity)

## License

MIT
