trinity Plugin

/plugin marketplace add abilityai/abilities
/plugin install trinity@abilityai
/trinity:start-here

One command that concierges a newcomer through the whole path — it sequences the skills below rather than replacing them, so you never have to know which one comes next.

Already know what you want? The individual skills below work standalone, in any order.

When /trinity:onboard detects it is running inside a deployed Trinity agent - the agent's own workspace, with the platform's MCP tools already injected - it offers Onboard in place as the recommended goal (or take it directly with /trinity:onboard in-place, which is also the one-line form an orchestrator dispatches after deploying a bare repo). Nothing is created; the agent already exists. Instead it:

Bootstrap for agents that predate declared plugins. The in-place path needs the trinity plugin present in the container. Agents created since Trinity re-installs declared plugins at boot get it from their template.yaml; an older agent has nothing declared yet, so run this once from its terminal, then start a fresh session:

claude plugin marketplace add abilityai/abilities && claude plugin install trinity@abilityai --yes

Onboarding in place is idempotent - if the push was refused, grant the agent write credentials and re-run.

The remote counterpart to Claude Code's built-in /loop. Where /loop re-invokes your local session on a cadence, /trinity:loop hands one bounded, sequential loop to a remote Trinity agent: it fires run_agent_loop once, returns a loop_id, and you can disconnect - the Trinity backend runs every iteration in order and exits on a hard cap or a stop signal. Use it for iterative refinement, agentic retry, and bounded polling that must outlive your session.

/trinity:loop [@agent] <message>             start a loop
/trinity:loop status <loop_id>               show per-run progress
/trinity:loop stop <loop_id>                 request a graceful stop

No @agent means this agent's remote copy - the usual case is looping your own remote counterpart on Trinity (resolved from .trinity-remote.yaml or by name match).

Modifiers, anywhere in the message:

Examples:

/trinity:loop @researcher draft section {{run}} of the report, 5 times
/trinity:loop @ci-agent run the test suite until it passes, max 10
/trinity:loop @monitor poll the deploy every 2m until it's healthy
/trinity:loop status loop_a1b2c3
/trinity:loop stop loop_a1b2c3

After firing, the skill starts a lightweight local watch by default - it polls the loop and reports run-by-run progress, stalls, and the final result. Say "fire and forget" to skip the watch; the remote loop runs either way and also appears on the agent's Loops tab in the Trinity web UI.

The loop mechanics - modes, template variables, stop signals, capacity, costs - are the platform's Sequential Agent Loops feature.

When to use what

/trinity:create-dashboard

Analyzes the agent's purpose and data sources, proposes a set of metrics, and - after your approval - scaffolds an agent-specific /update-dashboard skill that keeps dashboard.yaml current. Schedule that skill on Trinity to keep the agent's dashboard live. See Dynamic Dashboards.

/trinity:deploy-new-instance

Deploys a complete Trinity instance on any server you can reach - fresh installs and existing instances both - and scaffolds a dedicated ops agent to manage it (health checks, updates, rollbacks). See Deploying Trinity and the Trinity Ops Agent.

You can also deploy via the command line:

# Install CLI
pip install trinity-cli

# Initialize (one-time)
trinity init

# Deploy agent
trinity deploy .

See Trinity CLI for details.

Agents must have:

Optional but recommended: dashboard.yaml (custom metrics dashboard), .mcp.json.template (MCP server configuration), template.yaml schedules: (declared recurring work, materialized at creation), and template.yaml plugins: (declared Claude Code plugins, re-installed on every boot - declare trinity@abilityai at minimum)

The authoritative verdict is the platform's compatibility report (Agent Detail → Overview), which /trinity:onboard runs at the end of every path. See Creating Agents.