Trinity CLI

Command-line interface for the Trinity Autonomous Agent Orchestration Platform.

Install

# With pip
pip install trinity-cli

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

Quick Start

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

# 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

# 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

License

Apache-2.0

Metadata

Release files for trinity-cli 0.2.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for trinity-cli 0.2.8
File	Size	Uploaded
trinity_cli-0.2.8.tar.gz	17.1 kB	Sep 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for trinity-cli 0.2.8
File	Interpreter	ABI	Platform	Reset
trinity_cli-0.2.8-py3-none-any.whl 21.2 kB Sep 17, 2026	Python 3	none	any	Details

Total release size: 38.3 kB

Release files / trinity_cli-0.2.8.tar.gz

Download URL	trinity_cli-0.2.8.tar.gz
Size	17.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`92e6ee57eb2658dfb9d67576068afd9297bb582e5c17435414a61a627b6df602`
BLAKE2b-256 checksum How to use checksums	`72c30770e0f73eabbfaaebb9640ca5d189661b7e4a996bed3a6732c89f0bc51a`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Abilityai/trinity
Publishing commit: github.com/Abilityai/trinity/tree/e38c1c0f2567c602541c90c4c92152e99e6ead11

Workflow

Publishing configuration: github.com/Abilityai/trinity/blob/e38c1c0f2567c602541c90c4c92152e99e6ead11/.github/workflows/publish-cli.yml
Publishing logs: github.com/Abilityai/trinity/actions/runs/35251048883/attempts/1

Artifact

Subject: trinity_cli-0.2.8.tar.gz
SHA-256 checksum: 92e6ee57eb2658dfb9d67576068afd9297bb582e5c17435414a61a627b6df602 Verifying attestations

Release files / trinity_cli-0.2.8-py3-none-any.whl

Download URL	trinity_cli-0.2.8-py3-none-any.whl
Size	21.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`19a6185aef78ba720e792f1f366de2dea3d7d3f5ef2a7cfb97f0ec23aefe8e97`
BLAKE2b-256 checksum How to use checksums	`cb312512b66a7126228d869636105e557a75309c48f8fea52651e512dff7e628`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Abilityai/trinity
Publishing commit: github.com/Abilityai/trinity/tree/e38c1c0f2567c602541c90c4c92152e99e6ead11

Workflow

Publishing configuration: github.com/Abilityai/trinity/blob/e38c1c0f2567c602541c90c4c92152e99e6ead11/.github/workflows/publish-cli.yml
Publishing logs: github.com/Abilityai/trinity/actions/runs/35251048883/attempts/1

Artifact

Subject: trinity_cli-0.2.8-py3-none-any.whl
SHA-256 checksum: 19a6185aef78ba720e792f1f366de2dea3d7d3f5ef2a7cfb97f0ec23aefe8e97 Verifying attestations