diff --git a/docs/user-docs/abilities/overview.md b/docs/user-docs/abilities/overview.md index 439946130..c9ad6f42d 100644 --- a/docs/user-docs/abilities/overview.md +++ b/docs/user-docs/abilities/overview.md @@ -6,6 +6,16 @@ The official agent development toolkit for Claude Code. Curated plugins covering ## Quick Start +**New to Trinity?** Install the `trinity` plugin and run `/trinity:start-here` โ€” a guided, resumable journey from "what is Trinity?" to your first agent running on your own instance. It sequences everything below, so you don't have to pick a starting point: + +```bash +/plugin marketplace add abilityai/abilities +/plugin install trinity@abilityai +/trinity:start-here +``` + +Prefer to drive yourself? + ```bash # Add the abilities marketplace (one-time) /plugin marketplace add abilityai/abilities @@ -32,7 +42,7 @@ claude plugin install create-agent@abilityai |--------|--------|---------|------------| | [create-agent](create-agent-plugin.md) | 14 | Agent creation wizards | `/create-agent:prospector`, `/create-agent:custom` | | [agent-dev](agent-dev-plugin.md) | 20 | Extend existing agents | `/agent-dev:create-playbook`, `/agent-dev:add-memory`, `/agent-dev:add-orchestrator`, `/agent-dev:work-loop` | -| [trinity](trinity-plugin.md) | 6 | Deploy to and operate on Trinity | `/trinity:connect`, `/trinity:onboard`, `/trinity:loop` | +| [trinity](trinity-plugin.md) | 7 | Deploy to and operate on Trinity | `/trinity:start-here`, `/trinity:connect`, `/trinity:onboard`, `/trinity:loop` | | [dev-methodology](dev-methodology-plugin.md) | 24 | Development workflow | `/dev-methodology:implement`, `/dev-methodology:validate-pr` | | [utilities](utilities-plugin.md) | 7 | Ops and productivity | `/utilities:safe-deploy`, `/utilities:docker-ops` | diff --git a/docs/user-docs/abilities/trinity-plugin.md b/docs/user-docs/abilities/trinity-plugin.md index d609d7509..97049f766 100644 --- a/docs/user-docs/abilities/trinity-plugin.md +++ b/docs/user-docs/abilities/trinity-plugin.md @@ -1,6 +1,8 @@ # trinity Plugin -Connect, deploy, operate, and sync agents on the Trinity platform. Six skills covering the complete lifecycle โ€” from first connection to running remote loops and provisioning new instances. +Connect, deploy, operate, and sync agents on the Trinity platform. Seven skills covering the complete lifecycle โ€” from a guided first journey through connection, deployment, remote loops, and instance provisioning. + +> ๐Ÿงญ **New to Trinity? Start with `/trinity:start-here`** โ€” a guided, resumable walkthrough that takes you from "what is Trinity?" to your first agent running on your own instance. [Jump to the section](#the-guided-journey-trinitystart-here). > ๐Ÿ“บ **Watch:** [Build Autonomous Loops for Your AI Agents](https://youtu.be/q3YvFYtuhec) *(Jun 2026)* ยท [all videos](../videos.md) @@ -14,6 +16,7 @@ Connect, deploy, operate, and sync agents on the Trinity platform. Six skills co | Skill | Description | |-------|-------------| +| `/trinity:start-here` | **New here?** Guided, resumable journey: what Trinity is โ†’ get an instance โ†’ connect โ†’ first agent alive | | `/trinity:connect` | One-time: authenticate and configure the MCP connection | | `/trinity:onboard` | Per-agent: compatibility check, file creation, deploy | | `/trinity:sync` | Ongoing: sync changes between local and the running remote agent | @@ -21,6 +24,32 @@ Connect, deploy, operate, and sync agents on the Trinity platform. Six skills co | `/trinity:create-dashboard` | Generate an agent-specific `/update-dashboard` skill that keeps `dashboard.yaml` current | | `/trinity:deploy-new-instance` | Deploy a Trinity instance on any server and scaffold an ops agent to manage it | +## The Guided Journey: `/trinity:start-here` + +```bash +/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: + +| Stage | What happens | +|-------|--------------| +| **Orient** | What Trinity is, in plain terms, plus the current release | +| **Choose your door** | Just looking ยท build my first agent ยท I already have agents ยท set up my instance | +| **Get an instance** | Hands off to `/trinity:deploy-new-instance` (cloud, your server, or local Docker) โ€” or takes the URL you already have | +| **Connect + verify** | Hands off to `/trinity:connect`, then runs a live smoke test: fleet visible, instance healthy, docs assistant online | +| **First agent alive** | Deploys via `/trinity:onboard` (or picks an existing agent) and exchanges a real message with it | + +Three things worth knowing: + +- **Nothing is deployed until you choose it.** The "just looking" door asks for no credentials and creates nothing. +- **It resumes.** Progress is saved in `~/.trinity/start-here.json`, so quitting โ€” or the Claude Code restart needed to load the MCP server โ€” picks up exactly where you stopped. Run `/trinity:start-here reset` to start over. +- **Answers come from live documentation, not a script.** Questions are answered from these docs at run time โ€” through the public [Trinity Docs Q&A](../getting-started/help.md) before you have an instance, and through your instance's own `ask_trinity` tool afterward. + +Already know what you want? The individual skills below work standalone, in any order. + ## How It Works ### Step 1: Connect (One-Time) diff --git a/package-lock.json b/package-lock.json index 8fcac2672..7b7b48123 100644 --- a/package-lock.json +++ b/package-lock.json @@ -8,6 +8,18 @@ "@modelcontextprotocol/sdk": "^1.26.0" } }, + "node_modules/@hono/node-server": { + "version": "1.19.17", + "resolved": "https://registry.npmjs.org/@hono/node-server/-/node-server-1.19.17.tgz", + "integrity": "sha512-dSneS5qhiauZWGDCeK4o695Xd9nUNjviSZCMQrj10eetr8Uln1ucn6bbphOM6UynAMMtNIzZNSpL9vnASJwrPQ==", + "license": "MIT", + "engines": { + "node": ">=18.14.1" + }, + "peerDependencies": { + "hono": "^4" + } + }, "node_modules/@modelcontextprotocol/sdk": { "version": "1.26.0", "resolved": "https://registry.npmjs.org/@modelcontextprotocol/sdk/-/sdk-1.26.0.tgz", @@ -48,18 +60,6 @@ } } }, - "node_modules/@modelcontextprotocol/sdk/node_modules/@hono/node-server": { - "version": "1.19.14", - "resolved": "https://registry.npmjs.org/@hono/node-server/-/node-server-1.19.14.tgz", - "integrity": "sha512-GwtvgtXxnWsucXvbQXkRgqksiH2Qed37H9xHZocE5sA3N8O8O8/8FA3uclQXxXVzc9XBZuEOMK7+r02FmSpHtw==", - "license": "MIT", - "engines": { - "node": ">=18.14.1" - }, - "peerDependencies": { - "hono": "^4" - } - }, "node_modules/accepts": { "version": "2.0.0", "resolved": "https://registry.npmjs.org/accepts/-/accepts-2.0.0.tgz", @@ -437,9 +437,9 @@ "license": "MIT" }, "node_modules/fast-uri": { - "version": "3.1.4", - "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.4.tgz", - "integrity": "sha512-8JnbkQ4juDyvYs4mgFGQqg4yCYtFDtUtmp2QIQq11ZZe5CFQ5wcqm1rqDgAh/QdMySuBnPzMUiJUNZG5N/AiQw==", + "version": "3.1.5", + "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.5.tgz", + "integrity": "sha512-gHwA1O9LDIcKunMKhObS/HimwtehO1nPUECKAu5TpKgaO19fcWEl4bliWe1jWxVFvIXztJjjQ4L8XQ1EU9f7Jw==", "funding": [ { "type": "github", @@ -574,9 +574,9 @@ } }, "node_modules/hono": { - "version": "4.12.25", - "resolved": "https://registry.npmjs.org/hono/-/hono-4.12.25.tgz", - "integrity": "sha512-2NFaIyNVgJmBs/ecmtGzlmluTFs5cHEWGTdu0t1HBwYzoGXOL5nUQBRMXsXWla5i4KkG//QMzVP88m1+I3fdAQ==", + "version": "4.13.0", + "resolved": "https://registry.npmjs.org/hono/-/hono-4.13.0.tgz", + "integrity": "sha512-jhunvfHWxd7J5EFfSgH4xsYJzSe/lfqbUCxiyyeaQasUsXeEHXtzVid+7EOGByc5JnFa23SSFL3Y2RV/z1T+eQ==", "license": "MIT", "engines": { "node": ">=16.9.0" @@ -625,9 +625,9 @@ "license": "ISC" }, "node_modules/ip-address": { - "version": "10.2.0", - "resolved": "https://registry.npmjs.org/ip-address/-/ip-address-10.2.0.tgz", - "integrity": "sha512-/+S6j4E9AHvW9SWMSEY9Xfy66O5PWvVEJ08O0y5JGyEKQpojb0K0GKpz/v5HJ/G0vi3D2sjGK78119oXZeE0qA==", + "version": "10.4.0", + "resolved": "https://registry.npmjs.org/ip-address/-/ip-address-10.4.0.tgz", + "integrity": "sha512-oSK96Grm3aP6OrS263xVxbNDGVL7rzBtYdpGqlDG8iQdoenDoTs/nkki+DflYbAEE8Xl6o5YxhxlrKvI3nqKXQ==", "license": "MIT", "engines": { "node": ">= 12" diff --git a/package.json b/package.json index 1581aafba..543675337 100644 --- a/package.json +++ b/package.json @@ -5,7 +5,7 @@ "overrides": { "@modelcontextprotocol/sdk": "^1.26.0", "hono": ">=4.11.7", - "fast-uri": "^3.1.4", + "fast-uri": "^3.1.5", "@hono/node-server": "^1.19.13", "ip-address": ">=10.1.1", "qs": ">=6.15.2" diff --git a/src/frontend/package-lock.json b/src/frontend/package-lock.json index d3a651bd3..70fce9f34 100644 --- a/src/frontend/package-lock.json +++ b/src/frontend/package-lock.json @@ -19,7 +19,7 @@ "dompurify": "^3.4.11", "js-yaml": "^5.2.3", "marked": "^18.0.9", - "mermaid": "^11.16.0", + "mermaid": "^11.16.1", "monaco-editor": "^0.56.0", "pinia": "^4.0.2", "qrcode": "^1.5.4", diff --git a/src/frontend/package.json b/src/frontend/package.json index 2d15af9d4..d4aa41960 100644 --- a/src/frontend/package.json +++ b/src/frontend/package.json @@ -25,7 +25,7 @@ "dompurify": "^3.4.11", "js-yaml": "^5.2.3", "marked": "^18.0.9", - "mermaid": "^11.16.0", + "mermaid": "^11.16.1", "monaco-editor": "^0.56.0", "pinia": "^4.0.2", "qrcode": "^1.5.4", diff --git a/src/helper-mcp/package.json b/src/helper-mcp/package.json index 10b8dc5ca..709d7fa3f 100644 --- a/src/helper-mcp/package.json +++ b/src/helper-mcp/package.json @@ -43,7 +43,7 @@ "prepublishOnly": "npm run build && npm test" }, "dependencies": { - "@modelcontextprotocol/sdk": "^1.26.0", + "@modelcontextprotocol/sdk": "^1.30.0", "zod": "^3.24.1" }, "devDependencies": { diff --git a/src/mcp-server/package.json b/src/mcp-server/package.json index b9529430b..8926916f0 100644 --- a/src/mcp-server/package.json +++ b/src/mcp-server/package.json @@ -32,7 +32,7 @@ }, "overrides": { "@modelcontextprotocol/sdk": "^1.26.0", - "hono": ">=4.12.31", + "hono": ">=4.13.0", "axios": ">=1.15.2", "fast-uri": "^3.1.5", "@hono/node-server": ">=1.19.13",