Guides/Trinity CLI

Trinity CLI

Command-line interface for managing Trinity agents from your terminal. Provides the same capabilities as the MCP server but invoked via shell commands.

Watch

All videos

From Zero to Deployed AI Agent

Apr 2026

Installation

# PyPI (recommended)
pip install trinity-cli

# Homebrew (macOS/Linux)
brew install abilityai/tap/trinity-cli

# Verify installation
trinity --version

First-Time Setup

Run trinity init to connect to a Trinity instance:

trinity init

You'll be prompted for:

1Instance URL — Your Trinity server (e.g., trinity.example.com)

2Email — Your login email

3Verification code — 6-digit code sent to your email

The CLI stores credentials in ~/.trinity/config.json (mode 0600) and auto-provisions an MCP API key. Options: --profile <name> saves the instance under a named profile, and --admin logs in with the admin password instead of an email code.

Multi-Instance Profiles

Manage multiple Trinity instances (local, staging, production) with named profiles:

# List all profiles
trinity profile list

# Switch active profile
trinity profile use production

# Remove a profile
trinity profile remove staging

Profile resolution priority:

1TRINITY_URL / TRINITY_API_KEY environment variables

2--profile <name> flag

3TRINITY_PROFILE environment variable

4current_profile in config file

Returning Users

Re-authenticate with an existing profile:

trinity login                      # email code; --admin for the admin password
trinity login --instance https://trinity.example.com --profile staging   # add or repoint a profile
trinity status                     # which profile and instance you are on
trinity logout                     # clear the current profile's stored credentials

Agent Management

# List all agents
trinity agents list

# Get agent details
trinity agents get my-agent

# Create from GitHub template
trinity agents create my-agent --template github:user/repo

# Start/stop agents
trinity agents start my-agent
trinity agents stop my-agent

# Rename an agent
trinity agents rename old-name new-name

# Delete an agent
trinity agents delete my-agent

Deploy

Deploy a local agent directory to Trinity:

# Deploy current directory
trinity deploy .

# Deploy with custom name
trinity deploy . --name my-agent

# Deploy from GitHub
trinity deploy --repo user/repo

The CLI creates .trinity-remote.yaml to track deployments, enabling idempotent redeploys.

Chat and Logs

# Send a message
trinity chat my-agent "Hello, what can you do?"

# View chat history
trinity history my-agent

# View container logs
trinity logs my-agent

Health Monitoring

# Fleet-wide health status
trinity health fleet

# Single agent health
trinity health agent my-agent

Skills and Schedules

# List available skills
trinity skills list

# Get skill details
trinity skills get skill-name

# List agent schedules
trinity schedules list my-agent

# Trigger a schedule manually
trinity schedules trigger my-agent schedule-id

Output Formats

# Table output (default)
trinity agents list

# JSON output (for scripting)
trinity agents list --format json

Environment Variables

Variable	Description
TRINITY_URL	Override instance URL
TRINITY_API_KEY	Override authentication token
TRINITY_PROFILE	Set active profile

Limitations

•Covered today: agents, deploy, chat and history, logs, health, skills, schedules (list and trigger), tags, profiles.

•Not yet in the CLI: credentials, events, executions, systems, subscriptions — use the MCP server or the REST API for those.

MCP Integration Scheduling