Trinity CLI

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

Install

pip install trinity-cli

Quick Start

# Set up and authenticate
trinity init

# Check connection
trinity status

# List your agents
trinity agents list --format table

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

Authentication

Email Login (interactive)

# Full onboarding — request access + login in one step
trinity init

# Re-authenticate on a configured instance
trinity login

API Key (non-interactive)

export TRINITY_URL=https://your-instance.example.com
export TRINITY_API_KEY=trinity_mcp_...
trinity agents list

Commands

Auth & Config

Command	Description
trinity init	Configure instance, request access, and log in
trinity login	Log in with email verification
trinity logout	Clear stored credentials
trinity status	Show instance, user, and connection status

Agents

Command	Description
trinity agents list	List all agents
trinity agents get <name>	Get agent details
trinity agents create <name>	Create a new agent
trinity agents create <name> --template github:Org/repo	Create from a GitHub template
trinity agents delete <name>	Delete an agent
trinity agents start <name>	Start an agent
trinity agents stop <name>	Stop an agent
trinity agents rename <old> <new>	Rename an agent

Chat & Logs

Command	Description
trinity chat <agent> "message"	Send a message to an agent
trinity history <agent>	Get chat history
trinity logs <agent> [--tail N]	View agent logs

Health

Command	Description
trinity health fleet	Fleet-wide health status
trinity health agent <name>	Single agent health

Skills & Schedules

Command	Description
trinity skills list	List available skills
trinity skills get <name>	Get skill details
trinity schedules list <agent>	List agent schedules
trinity schedules trigger <agent> <id>	Trigger a schedule

Tags

Command	Description
trinity tags list	List all tags
trinity tags get <agent>	Get tags for an agent

Output Formats

# JSON (default)
trinity agents list | jq '.[].name'

# Table (human-readable)
trinity agents list --format table

Configuration

Stored in ~/.trinity/config.json (created with 0600 permissions):

{
  "instance_url": "https://your-instance.example.com",
  "token": "eyJ...",
  "user": {
    "email": "you@example.com",
    "role": "user"
  }
}

License

MIT