ต้นแบบ · รุ่นทดลอง: มีทุก server ในทะเบียนทางการ อัปเดตทุก 30 นาที เข้าสู่ระบบด้วย Google เพื่อเขียนรีวิวได้แล้วต้นแบบ · อัปเดตทุก 30 นาที
PopNx MCPที่รวม MCP สำหรับคนใช้ AI · วิธีติดตั้งภาษาไทยทุกตัว

Pug

โดย pug-shรุ่น 0.0.56i★ 111iรันบนคลาวด์เว็บทางการ ↗
ชื่อใน registrysh.pug/pug

วิธีติดตั้ง

ใช้ทำอะไรได้

Pug เป็นเครื่องมือวิเคราะห์ผลิตภัณฑ์ที่ใช้สืบค้นอีเวนต์ ฟันเนล การคงอยู่ของผู้ใช้ และโปรไฟล์ผู้ใช้ พร้อมสร้างแดชบอร์ดได้

แปลอัตโนมัติจากคำอธิบายของผู้ทำ · ทีมยังไม่ได้ตรวจ

  • ต่อแบบ คลาวด์ (ต่อผ่านอินเทอร์เน็ต)
  • บัญชีหรือคีย์ ล็อกอินกับบริการตอนต่อ (OAuth)
  • หมวด การตลาดและโซเชียล
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
Query events, funnels, retention and profiles in Pug product analytics, and build dashboards.

ใช้คู่กับ

Skill ที่สอน AI ทำงานแบบนี้ ใช้ร่วมกับตัวนี้ได้

scroll-world

scroll-world เป็นเครื่องมือที่เปลี่ยนแบรนด์ใดก็ได้ให้กลายเป็นหน้า landing page แบบโลก 3D ที่ผู้ใช้เลื่อนดูได้

โดย oso95★ 11,0551 skill

Skill · คู่มือ

social-auto-upload

social-auto-upload เป็นเครื่องมือสำหรับอัปโหลดวิดีโออัตโนมัติไปยังแพลตฟอร์มโซเชียลมีเดีย ได้แก่ Douyin, Xiaohongshu, Video Channel (WeChat), TikTok, YouTube และ Bilibili

โดย dreammis★ 16,657 (ของทั้งรีโป)4 skill

Skill · คู่มือ

native-subtitle-quote-image

保留视频内嵌字幕,精确取帧并生成 3:4 社交长图的 Agent Skill

โดย chengyi-ai★ 2,8881 skill

Skill · คู่มือ

ทำไมอยู่อันดับนี้

ตัวนี้อยู่ในแท็บ "แอปที่ต่อกับ AI" ซึ่งเรียงโดยไม่ใช้ดาว ตามลำดับเหล่านี้

1. อยู่ในสมุด connector ของ Claudeไม่
2. ทีมลองใช้จริงแล้วไม่
3. ใช้กับงานคนไทยไม่
4. การใช้งานไม่นับดาว20/100ความนิยม 0 · ความสด 12 · ระบบยังตอบ 8 · ถูกใจจากผู้ใช้ +0
5. ลงทะเบียนเมื่อ2026-11-13

ถูกใจจากผู้ใช้: 0 · บวกในลำดับได้สูงสุด 5 คะแนน (1 คะแนนต่อ 1 คน) ไม่มีใครจ่ายเงินเพื่อเพิ่มได้

คุณภาพ: ผลตรวจเบื้องต้นผ่าน 4/4 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง)

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ให้ AI ติดตั้งให้ด้วยประโยคเดียว

ติดตั้ง Pug ให้หน่อย ทำตาม https://mcp.popnx.com/i/sh-pug-pug.md แสดงคำสั่งให้ฉันดูและรอฉันตกลงก่อนรัน

คัดลอกไปวางในแชตของ AI ที่ทำงานในเครื่องคุณได้ (เช่น Claude Code, Cursor) · AI จะอ่านขั้นตอนจากเรา แสดงคำสั่งให้ดู และรอคุณตกลงก่อน · ไม่ต้องใช้คีย์ ไม่ต้องสมัคร · ดูข้อความเต็มที่ AI จะอ่าน

ผลตรวจผ่าน 4/4 · สิ่งที่คุณถามผ่านเซิร์ฟเวอร์ของผู้ทำ (api.pug.sh) · ✓ ตรวจคำสั่งแล้ว 13 พ.ย. 2569

ขั้นแรก: คุณใช้ AI ตัวไหน

เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง

ต่อกับ Claude ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ตั้งครั้งเดียวที่ claude.ai หรือแอปบนคอม แล้วใช้ในแชตได้ · บัญชีฟรีเพิ่มได้ 1 ตัว · แผน Team/Enterprise ให้เจ้าของ (Owner) เป็นคนเพิ่ม

  1. เปิดหน้า Connectors ของ Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. กด “Add” → “Custom” → “Web” แล้วกรอก 2 ช่องนี้

    คัดลอกจากที่นี่ไปวางในช่องชื่อเดียวกันบนหน้าจอของ Claude แล้วกด Continue

    Name · ชื่อPug
    Remote MCP server URL · ที่อยู่https://api.pug.sh/mcp

    กด Continue ผ่านหน้าตรวจการล็อกอินที่ Claude ตรวจเจอ · หัวข้อ Authentication เลือกตามที่ผู้ทำบอก (Sign in now, Sign in when needed หรือ No sign in) แล้วกด Add

  3. เปิดใช้ในแชต

    +ConnectorsPug

  4. ลองเลย

    ใช้ Pug บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Claude บอกว่ากำลังใช้ Pug หรือมีชื่อเครื่องมือของ Pug ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ ChatGPT ได้ ขึ้นกับแผน

MCP แบบเต็ม: ChatGPT Business, Enterprise หรือ Edu บนเว็บ · Pro: ต่อได้ด้วยสิทธิ์อ่านและดึงข้อมูล เครื่องมือที่แก้ข้อมูลอาจใช้ไม่ได้ · Plus: เอกสารยังไม่ยืนยัน ถ้าเห็นเมนูเพิ่ม MCP แบบกำหนดเองในหน้าปลั๊กอิน ลองตามขั้นตอนได้ · ใช้บนเว็บเท่านั้น

  1. เปิดหน้าเพิ่ม MCP ของ ChatGPT บนเว็บ

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. กรอกชื่อและที่อยู่

    ใส่ชื่อ แล้ววางที่อยู่ใต้ Connection ติ๊กยอมรับคำเตือน แล้วกด Create as a plugin

    Name · ชื่อPug
    Connection · ที่อยู่https://api.pug.sh/mcp
  3. เลือก Pug ในแชต

    เปิดแชตใหม่แล้วเลือก Pug จากรายการปลั๊กอินก่อนพิมพ์

  4. ลองเลย

    ใช้ Pug บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า ChatGPT บอกว่ากำลังใช้ Pug หรือมีชื่อเครื่องมือของ Pug ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ OpenAI เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ Claude Code ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม

  1. เปิด Terminal

    Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell

  2. วางคำสั่งนี้แล้วกด Enter

    claude mcp add --transport http --scope user pug https://api.pug.sh/mcp
  3. พิมพ์ /mcp ใน Claude Code

    ต้องเห็น Pug ในรายการและขึ้นว่าเชื่อมต่อแล้ว

  4. ลองเลย

    ใช้ Pug บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Claude Code บอกว่ากำลังใช้ Pug หรือมีชื่อเครื่องมือของ Pug ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ Cursor ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม

  1. กดปุ่มนี้เพื่อเปิด Cursor

    เปิดใน Cursor

    Cursor จะถามยืนยันการติดตั้ง ให้กด Install

  2. เปิดแชตของ AI ใน Cursor โหมด Agent

  3. ลองเลย

    ใช้ Pug บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Cursor บอกว่ากำลังใช้ Pug หรือมีชื่อเครื่องมือของ Pug ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ VS Code ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม

  1. กดปุ่มนี้เพื่อเปิด VS Code

    เปิดใน VS Code

    VS Code จะถามยืนยันการติดตั้ง ให้กด Install

  2. เปิดแชตของ AI ใน VS Code โหมด Agent

  3. ลองเลย

    ใช้ Pug บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า VS Code บอกว่ากำลังใช้ Pug หรือมีชื่อเครื่องมือของ Pug ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม

ดูโปรแกรมที่ใช้ MCP ทั้งหมด →

ที่อยู่สำหรับโปรแกรมที่ต่อผ่านเว็บ

ที่อยู่https://api.pug.sh/mcp

ค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง

ติดตรงไหน? ถามคนที่ใช้ Pug อยู่💬 พูดคุย →
สำหรับคนเขียนโค้ด: คำสั่ง Terminal และค่าตั้ง JSON

ต่อผ่านเว็บ

Claude Code

claude mcp add --transport http --scope user pug https://api.pug.sh/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "pug": {
      "url": "https://api.pug.sh/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "pug": {
      "type": "http",
      "url": "https://api.pug.sh/mcp"
    }
  }
}

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

สรุป

ดาวน์โหลดต่อสัปดาห์i
ไม่มียอดใน npm/PyPI
โดเมนที่ยืนยัน
✓ pug.sh
licensei
AGPL-3.0
การเชื่อมต่อ
รันบนคลาวด์
รุ่นล่าสุดi
0.0.56
ส่งเข้า registryi
13 พ.ย. 2569
แก้โค้ดล่าสุดi
18 พ.ย. 2569
ตรวจล่าสุดเมื่อ
18 พ.ย. 2569
ผู้ทำ
pug-sh
เว็บผู้ทำ
docs.pug.sh
สถานะใน registry
ใช้งานอยู่

ใช้กับโปรแกรมไหนได้

ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569

ต่อผ่านคลาวด์ได้ใน

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

ดูโปรแกรมทั้งหมดพร้อมข้อดีข้อเสีย →

คู่มือที่เกี่ยวข้อง

ทำอะไรได้บ้าง

server ให้ล็อกอินก่อนจึงจะแสดงรายการเครื่องมือ

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 19 พ.ย. 2569

  • ✓ ผ่าน

    ตัวตนผู้ทำตรงกับ repo

    ชื่อใน registry ยืนยันโดเมน pug.sh แล้ว (registry ตรวจความเป็นเจ้าของโดเมน)

  • ✓ ผ่าน

    ยังมีคนดูแล

    มีการแก้โค้ดล่าสุด เมื่อวาน

  • – ไม่เกี่ยว

    มีสัญญาอนุญาต (license)

    ไม่เกี่ยว: server บนคลาวด์ของเจ้าของ pug.sh เอง คุณไม่ได้รันโค้ดจากรีโป

  • ✓ ผ่าน

    endpoint ตอบ

    ตอบกลับใน 586 ms (HTTP 401)

  • ✓ ผ่าน

    ล็อกอินแบบ OAuth

    ประกาศวิธีล็อกอินแบบ OAuth ให้โปรแกรม AI พาไปล็อกอินเอง

  • … ยังไม่ตรวจ

    คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

    ยังไม่ได้ตรวจ เราอ่านรายการเครื่องมือตอนตรวจ endpoint

ที่อยู่บนคลาวด์ตอบได้ 4 จาก 4 ครั้งล่าสุด · ล่าสุด 586 ms · ตรวจเมื่อ 18 พ.ย. 2569

เราตรวจอะไรบ้าง → · JSON

ผู้ทำ: ขอให้ตรวจใหม่ หรือแจ้งข้อมูลผิด
สำหรับผู้ทำ: ติดป้ายใน README

ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้

[![แนะนำบน PopNx MCP](https://mcp.popnx.com/badge/sh-pug-pug.svg?lang=th)](https://mcp.popnx.com/th/servers/sh-pug-pug)

พูดคุย

ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์

ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย

ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx

เข้าสู่ระบบเพื่อโพสต์

รีวิวจากผู้ใช้

ยังไม่มีรีวิว

เข้าสู่ระบบเพื่อเขียนรีวิว

เทียบกับตัวอื่นในหมวด การตลาดและโซเชียลi

  • ดาวมากกว่า 99% ของอีก 4159 ตัวในหมวดนี้
  • ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 86% ของอีก 4159 ตัวในหมวดนี้
  • ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 99% ของอีก 4159 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

Pug ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 4 จาก 4 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

registry ไม่ได้ระบุว่าต้องใช้กุญแจ แต่บางตัวจะขอให้ล็อกอินตอนใช้ครั้งแรก

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนคลาวด์ของผู้ทำ ต่อผ่านอินเทอร์เน็ตได้เลย ไม่ต้องลงโปรแกรม แต่ข้อมูลที่ส่งให้จะผ่านเซิร์ฟเวอร์ของผู้ทำ

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด เมื่อวาน และส่งรุ่นล่าสุด (0.0.56) เข้า registry 6 วันที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต่อผ่าน URL จึงใช้กับโปรแกรมที่รับ remote MCP ได้ เช่น ChatGPT บนเว็บ (แบบเต็มในแผน Business ขึ้นไป · Pro แบบอ่านอย่างเดียว)

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี Relaticle, ChatbotX, X (Twitter) MCP Server by Xquik, Betterlytics, BibiGPT YouTube Video Summarizer

ตัวอื่นที่ทำงานคล้ายกัน

หมวดเดียวกันจากผู้ทำคนอื่น ผ่านตัวตรวจคำสั่งแล้ว ตัวทางการขึ้นก่อน แล้วเรียงตามดาว

อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

Relaticle

Open-source CRM your AI agents can write to: companies, people, opportunities, tasks and notes.

โดย relaticleกำลังโต★ 1.9Kอัปเดต 3 วันที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · relaticle.com

ChatbotX

Omnichannel customer messaging, CRM contacts, flows, sequences, broadcasts, and AI automation.

โดย ChatbotXIOกำลังโต★ 1.1K ดาวรวมทั้งรีโปอัปเดต 13 วันที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · chatbotx.io

Betterlytics

Query your Betterlytics web analytics from AI agents: traffic, funnels, journeys, errors, uptime.

โดย betterlyticsกำลังโต★ 196อัปเดต 4 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · betterlytics.io
เทียบกับตัวที่คล้ายกัน
ตัวนี้
Pug
RelaticleChatbotXX (Twitter) MCP Server by XquikBetterlyticsBibiGPT YouTube Video Summarizer
ทำงานที่ไหนใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่อง
ต้องใส่คีย์ไม่ไม่ไม่ไม่ใช่ไม่
กด + ใน Claude ได้ไม่ไม่ไม่ไม่ไม่ไม่
ผลตรวจเบื้องต้น4/44/44/44/44/44/4
สัญญาอนุญาตAGPL-3.0AGPL-3.0NOASSERTIONMITAGPL-3.0MIT
ราคาไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียน

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

Pug

Pug is an open-source product analytics platform. Capture events, identify the people behind them, and explore behavior through funnels, retention, trends, segmentation, and user-flow analysis, all surfaced on customizable dashboards.

Built in Go on PostgreSQL, ClickHouse, and NATS.

Features

  • Event ingestion: a NATS-backed capture pipeline with automatic geo, user-agent, bot-detection, and web-attribution enrichment.
  • Web analytics: an overview auto-built from your events: visitors, sessions, pageviews, bounce rate, and traffic sources, with no tile to wire up.
  • Live view: every visitor on a real-time world map, down to the person and the event they just fired.
  • Profiles: identify and alias the users behind events, with a ClickHouse-backed profile and activity API.
  • Insights: trends, funnels, retention, segmentation, user flow (Sankey), and top-K breakdowns, with filtering, breakdowns, and period-over-period comparison.
  • Dashboards: compose insight and markdown tiles on a grid with a board-level time window, accelerated by a pre-aggregated rollup fast path.
  • MCP server: Claude, ChatGPT, or any MCP client can query your insights, events, and profiles, and build dashboards for you.
  • Privacy & compliance: GDPR/DPDP data-subject erasure of a person's events and profile.

Overview : a web-analytics view auto-built from your events, with the previous period alongside.

Breakdowns : pageviews by country, plus locations, devices, and events; click any value to filter the whole view.

Live view : every visitor on a live world map; click one to fly to them and see the page, device, and profile behind it.

Events : every raw event as it lands, with its location, platform, properties, and the person behind it.

Dashboards : compose insight and markdown tiles on a time-windowed grid.

Insights : trends, filters, and breakdowns; here product views split by country.

Funnels : step-by-step conversion; here product view to purchase.

Profiles : the person behind the events, with traits, sessions, and activity.

MCP server

Pug serves a Model Context Protocol server, so an AI assistant can query your analytics. Sixteen tools read projects, dashboards, insights, events, sessions, and profiles, and one creates and edits dashboards.

EnvironmentEndpoint
Pug Cloudhttps://api.pug.sh/mcp
Self-hosted/mcp on your API host, e.g. http://localhost:3000/mcp

In Claude, add Pug from the connectors directory. Other clients take the endpoint as a custom connector. Connect by signing in to Pug, or with a project's private (prv_) API key in the x-api-key header. A self-hosted server offers sign-in only once PUG_API_BASE_URL is set. Setup steps for each client are in the MCP docs.

Tech stack

  • Go: backend services and workers, exposed over Connect RPC (HTTP/2)
  • PostgreSQL: relational store (orgs, projects, dashboards, auth)
  • ClickHouse: analytical store for events, insights, and profiles
  • NATS: messaging backbone for the ingestion and worker pipelines

Self-hosting

See the self-hosting guide. A Pug instance is this repo's backend, published as container images on ghcr.io/pug-sh, plus the dashboard from pug-sh/app, served as static files.

Quick start

# Build the binary into bin/pug

make build

Start dev infrastructure (PostgreSQL, NATS, ClickHouse)

make infra

Run migrations (Postgres, NATS, ClickHouse)

./bin/pug migrate

Seed the demo project with events, profiles, and dashboards

(resets the local Postgres and ClickHouse databases; see "Demo data" below)

./bin/pug seed

Start the dev server + workers together

./bin/pug dev

docs/development.md walks through each step, including signing in as the demo org's admin.

Environment variables are documented in .env.example. Google and generic OIDC sign-in are documented in docs/authentication.md, with a ready-to-copy config.example.json.

Demo data

./bin/pug seed fills a "Pug & Pals" demo project with ~6 months of history, so dashboards, insights, and profiles have something to show. Profiles are seeded only for users that produced events, so the data is internally consistent.

Local databases only. By default seed migrates Postgres and ClickHouse

all the way down and back up, dropping every table, not just the demo rows.

There is no confirmation prompt and no environment check: it connects to

whatever DATABASE_URL and CLICKHOUSE_URL resolve to, and an already

exported variable beats .env. Point it at a disposable local or demo

database.

Pass --no-reset to keep the schema; it then deletes the demo project's own events and profiles before re-seeding them, leaving other projects untouched. Volume is tunable with --count (default 500,000 events) and --batch (default 10,000 events per insert). Run it from the repo root; it reads the same .env as the rest of the CLI.

Two read-only accounts are seeded, plus an admin if you ask for one:

  • woof@pug.sh owns the demo org and its data. It has no password.
  • snoop@pug.sh is a viewer with no password; open /demo with PUG_DEMO_ENABLED=true to sign in as it.
  • admin@pug.example is the demo org's admin, seeded only when PUG_DEMO_ADMIN_PASSWORD is set (16 characters to 72 bytes, no surrounding whitespace), with that password. The address can't receive mail. Nothing logs the password, and later runs never change it, so change it in the dashboard, to 16 characters or more, and update the variable to match, since the seeder restores the admin's role only while they match. A default pug seed resets the database, though, and so recreates the admin from the current value.

For a live stream of traffic instead of a one-shot backfill, set PUG_DEMO_ENABLED=true: ./bin/pug dev then also runs the demo worker. It backfills an empty project once, so after pug seed it skips straight to playing new sessions out in real time. If you seed with a smaller --count, lower PUG_DEMO_SEED_COUNT to match: the worker reads a project holding fewer events than that as an interrupted backfill and warns rather than topping it up.

Development

make test    # run tests (race detector enabled)

make cover # run tests and write coverage.out make lint # lint Go code make sqlc # regenerate sqlc queries after editing SQL make rpc # regenerate protobuf code after editing .proto files make templ # regenerate templ email templates

Architecture

Per-subsystem documentation lives in docs/architecture/ (insights, ClickHouse, profiles, ingestion, email, telemetry). Contributor guidance and conventions are in CLAUDE.md.

License

Copyright (C) 2025 pug.sh contributors.

Pug is licensed under the GNU AGPL v3.0, or (at your option) any later version. Contributors sign a CLA before their first pull request is merged; see CONTRIBUTING.md.