English Français العربية

Terrarium

السجل الرسمي الذكاء الاصطناعي والوكلاء

Human visual review for agent-built HTML: publish artifacts, pull anchored comments, push fixes.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http terrarium 'https://www.tryterrarium.com/api/mcp' --header 'Authorization: <Bearer <PAT> — mint a personal access token at https://www.tryterrarium.com/connect>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "terrarium": {
            "type": "http",
            "url": "https://www.tryterrarium.com/api/mcp",
            "headers": {
                "Authorization": "<Bearer <PAT> — mint a personal access token at https://www.tryterrarium.com/connect>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Terrarium plugin for Claude Code
  2. Install
  3. What it ships
  4. The protocol

Terrarium plugin for Claude Code

Give your agent a place to show its work to humans. Terrarium hosts the HTML your agent builds; humans review it in the browser with comments anchored to exact passages; the agent pulls that feedback over MCP, pushes fixes, and repeats until approved.

Install

/plugin marketplace add nelsonsantryhkd/terrarium-plugin
/plugin install terrarium@terrarium

Then mint a token at tryterrarium.com/connect and make it available as TERRARIUM_PAT:

export TERRARIUM_PAT="samus_pat_…"

(Or just ask your agent to set Terrarium up — the bundled skill walks it through the whole flow, including sending you to /connect for the token.)

What it ships

  • MCP server (.mcp.json) — Terrarium's remote server over Streamable HTTP with 7 tools: list_artifacts, publish_artifact, get_artifact, pull_comments, push_version, reply_to_comment, resolve_comment.
  • Skill (skills/terrarium/) — teaches the publish → review → fix loop, including the terrarium-feedback/1 payload, expectedVersion freshness, and comment-thread etiquette.

The protocol

pull_comments returns a versioned, structured payload (terrarium-feedback/1) designed to be stable enough to build agents against: review state, typed comment threads (change_request / question / bug), text anchors with live resolution status, and reply chains. Evolution within /1 is additive-only.

الأسئلة الشائعة

ما هو Terrarium؟

Human visual review for agent-built HTML: publish artifacts, pull anchored comments, push fixes.

كيف أثبّت Terrarium؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http terrarium 'https://www.tryterrarium.com/api/mcp' --header 'Authorization: <Bearer <PAT> — mint a personal access token at https://www.tryterrarium.com/connect>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Terrarium إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل Terrarium مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Terrarium؟

ينشره nelsonsantryhkd. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.