Skip to main content
Trinity

Guides

Step-by-step tutorials for common tasks and advanced configurations. Each guide walks you through a complete workflow from start to finish.

Creating Agents

Create agents from templates, GitHub repos, or from scratch

Agent Runtimes

Run agents on a pluggable runtime — Claude Code (default), OpenAI Codex, or Gemini CLI

Managing Agents

Start, stop, rename, delete agents and monitor health

Agent Chat

The stateless per-turn chat on the agent page — real-time status, playbook autocomplete, attachments, and Stop

Agent Canvas

A surface the agent keeps current: blocks, the design kit, starter layouts, share links, and PDF export

Agent Terminal

Ephemeral key-based SSH access into an agent container; the WebSocket terminal for API clients

Continuous Conversations

What a resuming conversation preserves, how auto-compact works, the 50-turn agentic-loop cap, and how the stateless Chat tab differs from the Workspace

Agent Files

File browser, virtual filesystem, and shared folders

Agent Data & Portability

Declare runtime data paths, keep data out of git, and export/import an agent's data to move it between Trinity instances

Agent Logs

Log viewing, telemetry, and Vector aggregation

Agent Configuration

Autonomy levels, read-only mode, resources, and timeout settings

Platform Keys

Claude, GitHub, email (Resend) and Gemini keys, set from the browser

Credential Management

Inject, hot-reload, and back up agent credentials, plus the Credential Vault

OAuth Credentials

OAuth2 helper API for Google, Slack, GitHub, and Notion — authorization URLs, not a completed exchange

Subscription Credentials

Shared Claude subscriptions, auto-assign, auto-switch, headroom and weekly-limit alerts

MCP Integration

Connect Claude Code and other MCP clients to Trinity

A2A Protocol

A2A 0.3.0 in both directions: inbound tasking, and outbound calls to external agents

Trinity CLI

Command-line interface for managing agents from your terminal

Scheduling

Cron schedules, execution queue, and misfire handling

Self-Execute

Background tasks with activity tracking and result injection

Fan-Out

Parallel task dispatch with aggregated results

Agent Loops

Bounded sequential task repetition with templates, stop signals, and deadline, budget, and no-progress guardrails

Agent Self-Reminders

One-shot, durable, agent-initiated deferred follow-ups — an agent schedules a future re-invocation of itself that survives restarts

Skills and Playbooks

Multi-source skills library, assignment, injection, auto-sync, and playbooks

Approvals

Human-in-the-loop approval gates for agent actions — answered from the Operations queue, the mobile admin, or the Workspace user an ask is addressed to

GitHub Sync

Keep agents in sync with GitHub repositories

Slack Integration

Connect agents to Slack with DMs, mentions, and multi-agent routing

Nevermined Payments

x402 payment protocol for agent monetization

Agent Sharing

Share agents with other users and set access levels

Access Control

Cross-channel access control with email verification and approval workflows

Public Links

Public chat URLs, email verification, and session memory

Workspace

Signed-in chat app — chat tabs and a pinned Main, the composer, the rail, rooms, voice, and file upload

Tags and Organization

Tags, filtering, and system views

Mobile Admin

Mobile PWA at /m — agent status, the operator queue, autonomy toggles, and fleet controls

Advanced Features

Voice chat, VoIP telephony, image generation, agent avatars, and dynamic dashboards

Voice Chat

Real-time voice calls inside a Workspace chat — the orb, the agent's canvas, the transcript in the thread

VoIP Telephony

Agents place outbound phone calls via Twilio + Gemini Live

Voice Replies

Agents speak channel replies as ElevenLabs voice notes on Telegram, Slack, and WhatsApp — fail-soft to text

Image Generation

Gemini two-step image pipeline for agents

Agent Avatars

AI-generated avatars with emotion variants

Dynamic Dashboards

Custom agent dashboards via YAML configuration

Agent Guardrails

Deterministic safety enforcement for autonomous agent execution

GitHub PAT Setup

Configure a GitHub Personal Access Token for repository access

Telegram Integration

Connect agents to Telegram bots with DMs, groups, and @mentions

WhatsApp Integration

Connect agents to WhatsApp via Twilio — sandbox and production senders, email verification, and cross-channel access policies

Abilities Marketplace

Curated Claude Code plugins covering the full agent lifecycle — scaffold, develop, deploy, and iterate with 5 official plugins

Agent Compatibility Checklist

✓Dockerfile with SSH server (port 22) and agent-server.py
✓.env file for credential injection
✓.mcp.json.template with ${VAR} placeholders
✓Health check endpoint responding on the internal server