Skip to main content
Trinity

trinity Plugin

Connect, deploy, and sync agents to the Trinity platform. Five skills covering deployment, ops agent scaffolding, and dashboard generation.

Installation

/plugin install trinity@abilityai

Skills

SkillDescription
/trinity:deployDeploy current agent to Trinity (lighter-weight than onboard)
/trinity:connectOne-time: authenticate and configure MCP connection
/trinity:onboardPer-agent: compatibility check, file creation, deploy
/trinity:syncOngoing: sync changes between local and remote
/trinity:create-dashboardGenerate a schedulable /update-dashboard skill for an agent's Trinity dashboard

How It Works

Step 1: Connect (One-Time)

/trinity:connect

This:

1.Prompts for your Trinity instance URL
2.Authenticates via email verification
3.Provisions an MCP API key
4.Configures .mcp.json for Trinity MCP tools

After connecting, Trinity MCP tools become available: mcp__trinity__list_agents, mcp__trinity__chat_with_agent, mcp__trinity__deploy_local_agent

Step 2: Onboard (Per Agent)

/trinity:onboard

For each agent you want to deploy:

1.Compatibility check - Verifies required files exist
2.File creation - Generates missing Trinity files
3.Deploy - Pushes agent to Trinity platform

Step 3: Sync (Ongoing)

/trinity:sync

After making local changes: detects modified files, pushes updates to remote agent, and optionally restarts the agent.

/trinity:deploy — Deploy Current Agent

A lighter-weight alternative to /trinity:onboard— deploys the current agent to Trinity without the full compatibility check and file-creation flow. Useful for subsequent deploys after you've already onboarded once.

/trinity:deploy

To deploy a Trinity instance on a server (cloud or self-hosted), see the Deploying Trinity guide.

/trinity:create-dashboard — Dashboard Generator

Analyzes an agent's purpose and data sources, proposes a dashboard layout, gets your approval, then generates a schedulable /update-dashboard skill that keeps dashboard.yaml current on Trinity.

What it creates:

.claude/skills/update-dashboard/SKILL.md — a skill tailored to this agent's data sources
Metrics gathered from state files, logs, and JSON/YAML in the workspace
Writes to /home/developer/dashboard.yaml— Trinity's expected location
Designed to run on a cron schedule (e.g., hourly via Trinity scheduler)
/trinity:create-dashboard

# Then run the generated skill on a schedule:
# /trinity-schedules add update-dashboard --cron "0 * * * *"

Supports widget types: metric, status, progress, list, table, line/bar/area charts, pie/donut charts, and links.

Alternative: Trinity CLI

You can also deploy via the command line:

# Install CLI
pip install trinity-cli

# Initialize (one-time)
trinity init

# Deploy agent
trinity deploy .

Compatibility Requirements

Agents must have:

FilePurpose
CLAUDE.mdAgent identity and instructions
template.yamlTrinity metadata (name, description, type)
.env.exampleDocuments required environment variables

Optional but recommended: dashboard.yaml (custom metrics dashboard), .mcp.json.template (MCP server configuration)

See Also

Creating Agents - Agent creation in Trinity
Abilities Overview - Full toolkit overview