bugAgent

resmi

Hubungkan bugAgent ke klien AI yang kompatibel dengan MCP. Ajukan, klasifikasikan, dan kelola bug, permintaan fitur, dan lainnya langsung dari asisten coding AI Anda. Tanpa perpindahan konteks, tanpa salin-tempel — cukup jelaskan masalahnya dan bugAgent menangani sisanya.

Apa yang bisa Anda lakukan dengan bugAgent MCP?

Jelaskan bug dalam bahasa Inggris sederhana dan file bugAgent, mengklasifikasikan, serta mengelolanya untuk Anda.

  • Mengajukan dan mengklasifikasikan bug secara otomatis — Minta asisten Anda untuk mengajukan bug atau permintaan fitur dalam bahasa alami; create_bug_report mengklasifikasikannya secara otomatis ke dalam 19 jenis.
  • Mendaftar dan memfilter laporan — Minta bug terbaru atau kritis dalam sebuah proyek; list_bug_reports memfilter berdasarkan proyek, tingkat keparahan, status, dan lainnya.
  • Mengklaim dan mengelola antrean — Minta agen Anda memilih bug prioritas berikutnya dengan pick_next_bug dan mengklaimnya secara atomik melalui claim_bug.
  • Menjalankan pemindaian keamanan — Picu pemindaian kerentanan pada URL dengan run_security_scan dan tinjau temuan melalui get_security_results.
  • Membuat catatan pengembang — Minta analisis akar masalah dan saran perbaikan yang dihasilkan AI melalui push_to_claude untuk laporan bug apa pun.

Dokumentasi

MCP v1

Navigasi

Model Context Protocol

MCP

Hubungkan bug_Agent_ ke klien AI apa pun yang kompatibel dengan MCP.

Laporkan, klasifikasikan, dan kelola bug, permintaan fitur, dan lainnya langsung dari asisten coding AI Anda. Tanpa berpindah konteks, tanpa salin-tempel — cukup deskripsikan masalahnya dan bug_Agent_ menangani sisanya.

Komunitas Discord support@bugagent.com

Memulai

Server MCP bug_Agent_ memungkinkan klien AI membuat, menanyakan, dan mengelola laporan bug, permintaan fitur, peningkatan, dan lainnya melalui Model Context Protocol. Server ini berjalan secara lokal dan berkomunikasi dengan API cloud bug_Agent_.

1

Dapatkan kunci API Anda

Buat akun Gratis; pemilik workspace baru langsung diarahkan ke pengaturan kunci API. Pengguna yang sudah ada dapat membuat kunci dari Pengaturan → Pengembang → Kunci API.

2

Konfigurasikan klien AI Anda

Tambahkan bug_Agent_ sebagai server MCP di konfigurasi klien Anda (lihat pengaturan di bawah).

3

Mulai melaporkan bug

Deskripsikan bug dalam bahasa alami dan bug_Agent_ secara otomatis mengklasifikasikan, memperkaya, dan menyimpannya.

Contoh Cepat

# Create a bug report
"File a bug: Login button is unresponsive on iOS Safari.
Steps: tap login, nothing happens. Expected: navigate to
dashboard. Severity: high."

# bugAgent auto-classifies as UI bug, severity high

# File a feature request
"Feature request: Add dark mode toggle to the
settings page. Users have asked for this in surveys."

# Auto-classified as feature-request, severity medium

Pengaturan

Instalasi

Tidak perlu instalasi global. Gunakan npx untuk menjalankan server MCP sesuai permintaan:

npx @bugagent/mcp-server

Konfigurasi kunci API Anda

Saat pertama kali terhubung, bug_Agent_ akan meminta kunci API Anda. Anda juga dapat mengaturnya melalui variabel lingkungan:

export BUGAGENT_API_KEY=ba_live_your_key_here

Dapatkan kunci API Anda dari konsol bug_Agent_.

Konfigurasi Klien MCP

Tambahkan berikut ini ke file konfigurasi klien MCP Anda:

mcp.json

{
  "mcpServers": {
    "bugagent": {
      "command": "npx",
      "args": ["-y", "@bugagent/mcp-server"],
      "env": {
        "BUGAGENT_API_KEY": "ba_live_your_key_here"
      }
    }
  }
}

💡

Ganti ba_live_your_key_here dengan kunci API Anda yang sebenarnya dari konsol.

Menghubungkan ke Server

Server MCP bug_Agent_ aktif di https://mcp.bugagent.com/mcp melalui transport Streamable HTTP. Hubungkan dari salah satu dari delapan klien di bawah — pilih yang sesuai dengan alur kerja Anda.

Untuk konfigurasi siap-salin yang ringkas, panduan kunci terbatas, dan prompt awal yang aman, gunakan quickstart MCP publik.

🔑

Dapatkan kunci API Anda terlebih dahulu. Masuk ke Pengaturan → Pengembang, klik Buat Kunci API, dan salin nilainya (dimulai dengan ba_live_). Anda hanya akan melihatnya sekali, jadi simpan di tempat yang aman. Setiap contoh di bawah menggunakan kunci ini.

Opsi 1 — MCP Inspector (UI Web, direkomendasikan untuk pengujian pertama kali)

Alat resmi dari Anthropic. Membuka UI web lokal tempat Anda dapat mengklik setiap alat, mengisi parameter, dan melihat respons. Tanpa konfigurasi, tanpa IDE.

macOS (Terminal)

Terminal

npx @modelcontextprotocol/inspector

Windows (PowerShell atau CMD)

PowerShell

Di UI browser yang terbuka:

  1. Tipe Transport: pilih Streamable HTTP
  2. URL: https://mcp.bugagent.com/mcp
  3. Tipe Koneksi: pilih Proxy (default — Inspector memproksi melalui proses Node lokal untuk melewati CORS browser)
  4. Klik tab Autentikasi → tambahkan header kustom:
    • Nama Header: Authorization
    • Nilai: Bearer ba_live_YOUR_KEY_HERE
  5. Klik Hubungkan. Anda akan melihat semua 110+ alat bug_Agent_ di panel kiri.
  6. Klik alat apa pun (mis. list_bug_reports), isi parameter, klik Jalankan Alat. Respons muncul di kanan.

Prasyarat: Node.js 18 atau lebih baru. Instal dari nodejs.org jika Anda belum memilikinya.

Opsi 2 — Claude Desktop (Mac + Windows)

Jika Anda menggunakan aplikasi Claude Desktop, Anda dapat menambahkan bug_Agent_ sebagai server MCP permanen. Claude kemudian akan memiliki semua alat bug_Agent_ yang tersedia di setiap percakapan.

macOS

  1. Buka Claude Desktop → bilah menu Claude → Pengaturan → Pengembang → Edit Konfigurasi. Ini membuka ~/Library/Application Support/Claude/claude_desktop_config.json.
  2. Tambahkan entri bug_Agent_ di bawah mcpServers:
    claude_desktop_config.json
{  
  "mcpServers": {  
    "bugagent": {  
      "type": "http",  
      "url": "https://mcp.bugagent.com/mcp",  
      "headers": {  
        "Authorization": "Bearer ba_live_YOUR_KEY_HERE"  
      }  
    }  
  }  
}  
  1. Simpan file dan keluar sepenuhnya dari Claude Desktop (Cmd+Q, bukan hanya menutup jendela).
  2. Luncurkan kembali Claude Desktop. Ikon palu alat di bagian bawah input obrolan sekarang akan menampilkan alat bug_Agent_.
  3. Coba: ketik "Daftarkan 5 laporan bug terbaru saya" — Claude akan memanggil list_bug_reports secara otomatis.

Windows

  1. Buka Claude Desktop → File → Pengaturan → Pengembang → Edit Konfigurasi. Ini membuka %APPDATA%\Claude\claude_desktop_config.json (biasanya C:\Users\YourName\AppData\Roaming\Claude\claude_desktop_config.json).
  2. Tambahkan blok JSON yang sama seperti yang ditunjukkan di bagian macOS.
  3. Simpan file dan keluar sepenuhnya dari Claude Desktop dari baki sistem (klik kanan ikon Claude → Keluar), lalu luncurkan kembali.
  4. Ikon palu alat akan menampilkan alat bug_Agent_.

Opsi 3 — Claude Code (CLI)

Jika Anda menggunakan Claude Code dari terminal (versi CLI dari Claude), daftarkan server bug_Agent_ dengan satu perintah. Berfungsi sama di macOS, Linux, dan Windows.

Terminal / PowerShell

claude mcp add --transport http bugagent https://mcp.bugagent.com/mcp \
  --header "Authorization: Bearer ba_live_YOUR_KEY_HERE"

Kemudian mulai ulang sesi Claude Code Anda. Verifikasi bahwa sudah terhubung:

claude mcp list

Anda akan melihat bugagent dalam daftar dengan titik hijau. Mulai gunakan alat di obrolan mana pun: "Tunjukkan penggunaan eksplorasi saya bulan ini."

Untuk menghapusnya nanti:

claude mcp remove bugagent

Opsi 4 — OpenAI Codex CLI

Jika Anda menggunakan OpenAI Codex CLI, tambahkan bug_Agent_ ke ~/.codex/config.toml untuk pendaftaran permanen, atau berikan konfigurasi secara inline untuk sesi satu kali.

Pendaftaran permanen (tambahkan ke konfigurasi)

~/.codex/config.toml

[[mcp_servers]]
name = "bugagent"
type = "http"
url  = "https://mcp.bugagent.com/mcp"

[mcp_servers.headers]
Authorization = "Bearer ba_live_YOUR_KEY_HERE"

Inline — satu sesi

Terminal

codex \
  --mcp-server '{"name":"bugagent","type":"http","url":"https://mcp.bugagent.com/mcp","headers":{"Authorization":"Bearer ba_live_YOUR_KEY_HERE"}}' \
  "list the last 5 bug reports"

Codex menyelesaikan panggilan alat secara otomatis dari prompt bahasa alami Anda. Coba: "Daftarkan bug terbuka saya yang diurutkan berdasarkan tingkat keparahan."

Opsi 5 — Cursor (Mac + Windows)

Cursor memiliki dukungan MCP bawaan. Tambahkan bug_Agent_ sekali dan asisten AI di dalam Cursor dapat melaporkan bug, membuat daftar laporan, menjalankan pemindaian, dll. tanpa meninggalkan editor Anda.

  1. Buka Cursor → Pengaturan (Cmd+, di Mac / Ctrl+, di Windows) → MCP di sidebar kiri.
  2. Klik + Tambah server MCP baru.
  3. Pilih tipe transport HTTP.
  4. Isi:
    • Nama: bugagent
    • URL: https://mcp.bugagent.com/mcp
    • Nama header: Authorization
    • Nilai header: Bearer ba_live_YOUR_KEY_HERE
  5. Klik Simpan. Cursor menampilkan indikator hijau saat terhubung.
  6. Buka obrolan Cursor (Cmd+L / Ctrl+L) dan ketik "Buat laporan bug berjudul 'Login rusak' dengan tingkat keparahan tinggi." Cursor akan memanggil create_bug_report.

Alternatif: Cursor juga membaca ~/.cursor/mcp.json (Mac) atau %USERPROFILE%\.cursor\mcp.json (Windows). Tambahkan format JSON yang sama seperti yang ditunjukkan di bagian Claude Desktop.

Opsi 6 — VS Code dengan ekstensi Continue (Mac + Windows)

Jika Anda lebih suka VS Code, ekstensi Continue mendukung server MCP secara native.

  1. Instal ekstensi Continue dari marketplace VS Code.
  2. Buka konfigurasi Continue: Palet Perintah (Cmd+Shift+P / Ctrl+Shift+P) → Continue: Buka config.json. File berada di:
    • macOS: ~/.continue/config.json
    • Windows: %USERPROFILE%\.continue\config.json
  3. Tambahkan entri mcpServers:
    ~/.continue/config.json
{  
  "mcpServers": [  
    {  
      "name": "bugagent",  
      "type": "streamable-http",  
      "url": "https://mcp.bugagent.com/mcp",  
      "requestOptions": {  
        "headers": {  
          "Authorization": "Bearer ba_live_YOUR_KEY_HERE"  
        }  
      }  
    }  
  ]  
}  
  1. Simpan. Continue akan memuat ulang secara otomatis dan menampilkan alat bug_Agent_ di sidebar.
  2. Buka panel obrolan Continue dan coba: "Daftarkan pemindaian keamanan saya."

Ekstensi lain yang mendukung MCP di VS Code: Cline, Roo Code, dan Windsurf (fork) semuanya mengikuti pola konfigurasi JSON serupa dengan kunci mcpServers dan transport HTTP.

Opsi 7 — Host yang mendukung OAuth (Claude.ai web ditampilkan sebagai contoh)

Beberapa host MCP melakukan autentikasi melalui OAuth 2.0 dan meminta client_id dan client_secret statis di awal, alih-alih menerima kunci API bearer. Untuk host tersebut, Anda membuat pasangan kredensial OAuth terbatas workspace dari dasbor bug_Agent_ dan menempelkannya ke formulir konektor host. Kredensial tersebut tidak bergantung pada host MCP — klien OAuth mana pun yang mendukung Authorization Code + PKCE dapat menggunakannya. Panduan di bawah menggunakan aplikasi web Claude.ai sebagai contoh yang paling umum.

  1. Di bug_Agent_: buka Pengaturan → Pengembang → Konektor MCP. Klik Buat konektor, beri nama yang mendeskripsikan host (mis. "Claude.ai (kerja)"), tempel URI redirect yang diminta host MCP Anda (untuk aplikasi web Claude.ai itu adalah https://claude.ai/api/mcp/auth_callback — periksa dokumen konektor host Anda untuk yang lain), dan pilih Rahasia untuk metode autentikasi. Salin client_id dan client_secret yang ditampilkan sekali di layar sukses.
  2. Di pengaturan konektor / OAuth host MCP Anda, tempel:
    • URL Server: https://mcp.bugagent.com/mcp
    • Client ID + Client Secret: dari langkah 1
    • URL Otorisasi: https://mcp.bugagent.com/authorize
    • URL Token: https://mcp.bugagent.com/token
      Untuk Claude.ai secara khusus: buka claude.ai/customize/connectors dan klik Tambahkan konektor MCP.
  3. Simpan. Host mengarahkan Anda ke bug_Agent_ untuk masuk (Google atau email/kata sandi — metode mana pun yang Anda gunakan untuk dasbor) dan menyetujui izin, lalu menyelesaikan jabat tangan OAuth.
  4. Kelola dan cabut konektor yang dibuat dari halaman Pengaturan yang sama. Pencabutan bersifat langsung — permintaan berikutnya dari konektor tersebut mengembalikan invalid_client.

Catatan: Claude Code, Cursor, VS Code, dan MCP Inspector tidak memerlukan alur ini — mereka menangani pendaftaran klien dinamis (RFC 7591) secara otomatis dan melakukan autentikasi melalui kunci API seperti yang ditunjukkan di atas. Formulir Konektor MCP hanya untuk host yang memerlukan kredensial OAuth statis.

Opsi 8 — HTTP langsung dengan curl (Terminal)

Jika Anda ingin menguji server secara langsung tanpa klien, atau mengintegrasikannya ke dalam skrip, Anda dapat memanggil endpoint HTTP dengan curl. Protokol MCP adalah JSON-RPC 2.0 melalui Streamable HTTP.

macOS / Linux

Terminal

# Set your API key as a variable
export BUGAGENT_API_KEY="ba_live_YOUR_KEY_HERE"

# 1. List all available tools
curl -N -s https://mcp.bugagent.com/mcp \
  -H "Authorization: Bearer $BUGAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# 2. Call a tool — list 5 reports from a specific project
curl -N -s https://mcp.bugagent.com/mcp \
  -H "Authorization: Bearer $BUGAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc":"2.0",
    "id":2,
    "method":"tools/call",
    "params":{
      "name":"list_bug_reports",
      "arguments":{"project":"bugagent","limit":5}
    }
  }'

Windows (PowerShell)

PowerShell

# Set your API key
$env:BUGAGENT_API_KEY = "ba_live_YOUR_KEY_HERE"

# Use Invoke-RestMethod (PowerShell's curl equivalent)
$headers = @{
  "Authorization" = "Bearer $env:BUGAGENT_API_KEY"
  "Content-Type" = "application/json"
  "Accept" = "application/json, text/event-stream"
}

# 1. List all tools
$body = '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Invoke-RestMethod -Uri "https://mcp.bugagent.com/mcp" `
  -Method Post -Headers $headers -Body $body

# 2. Call list_bug_reports for a specific project
$body = @{
  jsonrpc = "2.0"
  id = 2
  method = "tools/call"
  params = @{
    name = "list_bug_reports"
    arguments = @{ project = "bugagent"; limit = 5 }
  }
} | ConvertTo-Json -Depth 5

Invoke-RestMethod -Uri "https://mcp.bugagent.com/mcp" `
  -Method Post -Headers $headers -Body $body

Respons tiba sebagai Server-Sent Events (standar MCP Streamable HTTP). Setiap potongan adalah baris yang diawali dengan data: diikuti oleh objek JSON. Header Accept: application/json, text/event-stream wajib — server menolak permintaan tanpa header tersebut.

ℹ️

Pemecahan Masalah 401 Tidak Diizinkan: Periksa apakah kunci API Anda belum dicabut di Pengaturan → Pengembang. Kunci dimulai dengan ba_live_. Jika masih bermasalah, buat ulang kunci dan coba lagi.

Coba — Prompt Bahasa Inggris Sederhana

Setelah terhubung, Anda tidak perlu tahu nama alat atau parameter. Deskripsikan apa yang Anda inginkan dalam bahasa Inggris sederhana dan asisten AI Anda akan memanggil alat bug_Agent_ yang tepat secara otomatis.

Laporan Bug

Tanyakan asisten AI Anda

List my 5 most recent bug reports
Show all open critical bugs in the Auth project
Create a bug titled "Login broken on Safari" with severity s2
Update TEST-451 status to in-progress and assign it to me
Add a comment to TEST-451: "root cause confirmed — null check missing in auth middleware"
Show me everything filed this week, grouped by severity

Manajemen Pengujian

Create a test suite called "Smoke Tests" with cases for login, checkout, and account settings
Run the Regression suite and list all failures
Use Hermes to execute the curated "Checkout smoke" suite and report every result to bugAgent
Show failing test cases from the last 7 days
Which test cases have never been run in the past 90 days?
Get a pass-rate trend for this month vs last month

Keamanan & Kinerja

Run a security scan on https://app.example.com
Get this month's security scan results — show only high and critical findings
Create a performance test for the landing page and check Lighthouse scores
What are the Core Web Vitals for our checkout flow?

Otomatisasi Playwright

Create a Playwright script that logs in and verifies the dashboard loads
Run the checkout automation on iPhone 15 Pro on a real device
Optimize the login automation script
Show runs for the checkout automation — any failures?
Schedule the smoke test suite to run every weekday at 6 AM UTC

AI Eksploratif

Run an exploratory AI session on https://app.example.com with 5 parallel agents
Get the latest exploration run results — list any bugs that were filed
What testing strategies did the agents use and which found the most issues?

Penggunaan & Statistik

Check my plan usage for this month
Show team bug stats for this week broken down by severity and type
List all team members and their roles
How many security scans do I have left this month?

Referensi Cepat

Lokasi file konfigurasi untuk semua delapan klien. Setiap klien terhubung ke https://mcp.bugagent.com/mcp dengan header Authorization: Bearer ba_live_YOUR_KEY_HERE melalui Streamable HTTP.

Klien Lokasi konfigurasi / perintah

MCP Inspector Tidak ada file — masukkan URL + header autentikasi di UI browser setelah npx @modelcontextprotocol/inspector

Claude Desktop — macOS ~/Library/Application Support/Claude/claude_desktop_config.json

Claude Desktop — Windows %APPDATA%\Claude\claude_desktop_config.json

Claude Code (CLI) claude mcp add --transport http bugagent https://mcp.bugagent.com/mcp --header "Authorization: Bearer ba_live_..."

Codex CLI ~/.codex/config.toml

Cursor — macOS Pengaturan → UI MCP, atau ~/.cursor/mcp.json

Cursor — Windows %USERPROFILE%\.cursor\mcp.json

VS Code + Continue ~/.continue/config.json (macOS) / %USERPROFILE%\.continue\config.json (Windows)

HTTP langsung (curl) curl / Invoke-RestMethod — sertakan Accept: application/json, text/event-stream

Pemecahan Masalah

Gejala Perbaikan

401 Unauthorized Kunci salah, kedaluwarsa, atau dicabut. Periksa Pengaturan → Pengembang — kunci dimulai dengan ba_live_. Buat ulang jika diperlukan.

Alat tidak muncul di klien Keluar sepenuhnya dan luncurkan kembali klien setelah mengedit konfigurasi. Di Claude Desktop, Cmd+Q (bukan hanya menutup jendela). Di Cursor, periksa Pengaturan → MCP untuk titik hijau.

Accept header required Panggilan HTTP langsung harus menyertakan Accept: application/json, text/event-stream — spesifikasi Streamable HTTP mewajibkannya. Server mengembalikan 406 tanpa itu.

Data workspace yang salah Setiap kunci API terbatas pada satu workspace. Buat kunci baru dari workspace yang ingin Anda kueri di Pengaturan → Pengembang.

Alat muncul tetapi panggilan gagal secara diam-diam Pastikan server dapat dijangkau: curl -I https://mcp.bugagent.com/health harus mengembalikan 200. Jika waktu habis, periksa aturan jaringan/firewall.

Kesalahan CORS MCP Inspector Pilih Proxy (bukan Langsung) untuk Tipe Koneksi di UI Inspector. Inspector memproksi melalui proses Node lokal untuk melewati batasan CORS browser.

Codex CLI — alat tidak dikenali Verifikasi bahwa ~/.codex/config.toml menggunakan [[mcp_servers]] (kurung ganda, sintaks array). Periksa versi Codex CLI cukup baru untuk mendukung MCP (codex --version).

Fitur MCP

Server MCP bug_Agent_ menyediakan alat untuk:

🐛

Manajemen Laporan Bug

  • create_bug_report — Ajukan laporan baru dengan klasifikasi otomatis di 19 jenis — bug, permintaan fitur, peningkatan, utang teknis, dan lainnya (judul: 3-500 karakter). Array opsional attachments menerima file berenkode base64 hingga 400 MB per file: gambar, video, audio, PDF, atau teks/JSON apa pun. Atur format_description: true untuk memformat ulang deskripsi secara otomatis menjadi templat terstruktur menggunakan AI. Berikan time_spent_seconds untuk melacak upaya QA. Berikan priority (urgent / high / normal / low) untuk mengatur urgensi perbaikan secara independen dari tingkat keparahan. Berikan is_epic: true untuk membuat Epic, atau parent_epic_id (UUID/ID pendek) untuk membuat anak di proyek terotorisasi yang sama. Respons menyertakan kolom hierarki plus project_id, project, short_id, legacy_short_id, dan project_short_id.
  • list_bug_reports — Daftarkan dan filter laporan (maks 100 per halaman). Filter proyek diterapkan di sisi server sebelum paginasi. Filter berdasarkan project (UUID, slug, nama persis, atau prefiks tiket), project_id, project_slug, project_prefix, workspace (UUID, nama persis, atau prefiks tiket workspace), workspace_id/team_id, is_epic, type, severity, status, resolution, root_cause, atau reporter_user_id. Setiap hasil menyertakan pengidentifikasi orang/proyek yang terbatas pada tenant plus is_epic, parent_epic_id, parent_epic, dan epic_progress yang dibatasi. Alat pembaca laporan tidak mengekspos alamat email anggota.
  • pick_next_bug — Mengembalikan bug berikutnya yang harus dikerjakan oleh loop agen, dalam urutan prioritas (S1 → S2 → S3, terlama lebih dulu dalam setiap kelompok). Otomatis dibatasi ke workspace Anda — mengembalikan tiket di semua proyek dalam tim Anda dengan status new, awaiting-triage, atau confirmed dan tingkat keparahan S1-S3. Hanya-baca — tidak mengklaim tiket secara atomik. Opsional severity (satu tingkat), limit (1-50, default 1). Mengembalikan baris dengan bentuk yang sama seperti list_bug_reports untuk komposabilitas alat. Pasangkan dengan claim_bug untuk pola baca-lalu-klaim.
  • claim_bug — Transisikan bug secara atomik dari status new, awaiting-triage, atau confirmed ke status='in-progress', atur assigned_to ke pengguna yang memanggil, dan beri stempel claimed_at=NOW(). Bebas race condition di antara pemanggil konkuren melalui pola UPDATE-WHERE-RETURNING Postgres — jika dua agen memanggil claim_bug pada id yang sama secara berurutan, tepat satu yang mendapatkan claimed:true dengan isi bug dan yang lainnya mendapatkan claimed:false dengan string alasan. Respons yang berhasil menyertakan reporter_user_id, reporter_name, assigned_to, dan assignee_name. Reaper pg_cron melepaskan klaim basi (status=in-progress + claimed_at > 30 menit) kembali ke new secara otomatis, sehingga tiket agen yang crash masuk kembali ke antrean tanpa intervensi manual. Input: id (UUID atau ID pendek).
  • get_bug_report — Dapatkan detail lengkap laporan berdasarkan UUID atau ID pendek workspace/proyek. Mengembalikan kolom standar orang/proyek/kualitas plus is_epic, identitas induk, progres agregat, dan halaman anak pertama yang dibatasi untuk Epic.
  • list_epic_children — Paginasi laporan anak Epic dengan id, limit (1–100), dan offset. Mengembalikan children, total, has_more, dan epic_progress yang diagregasi SQL tanpa memuat setiap laporan anak.
  • update_bug_report — Perbarui kolom laporan standar plus is_epic dan parent_epic_id. Berikan parent_epic_id: null untuk melepas; reparent/lepas bersifat atomik dan memerlukan otorisasi workspace yang sama, proyek yang sama. Menaikkan ke Epic melepas induk yang ada, sedangkan Epic dengan anak tidak dapat diturunkan. Aturan notifikasi status/resolusi/akar masalah dan penugasan yang ada tetap berlaku.
  • add_comment — Tambahkan komentar ke laporan bug (UUID atau ID pendek, isi 1-10000 karakter). Jika laporan disinkronkan ke Jira, komentar otomatis didorong ke isu Jira yang tertaut.
  • list_comments — Daftarkan seluruh utas komentar laporan, terlama lebih dulu — setiap komentar dengan nama penulis, parentId (balasan berutas), dan stempel waktu. Komentar bukan bagian dari get_bug_report, jadi ini cara Anda membaca diskusi tiket. Menerima UUID atau ID pendek.
  • link_bug_reports — Buat tautan semantik berarah antara dua laporan di proyek terotorisasi yang sama. Untuk parent-of, laporan-asal harus berupa Epic dan laporan-tujuan anak standar. Utamakan parent_epic_id saat membuat/memperbarui untuk penugasan Epic.
  • unlink_bug_reports — Hapus tautan laporan bug yang dibuat sebelumnya berdasarkan UUID-nya (link_id, dikembalikan oleh link_bug_reports atau list_bug_report_links).
  • list_bug_report_links — Daftarkan setiap tautan kurasi pengguna yang menyentuh laporan bug. Mengembalikan setiap tautan sebagaimana terbaca dari perspektif laporan yang diberikan — mis. baris duplicate-of yang tersimpan di mana laporan ini adalah target dirender sebagai duplicated-by; parent-of di mana laporan ini adalah target dirender sebagai subtask-of; depends-on di mana laporan ini adalah target dirender sebagai blocks; testing-blocked-by di mana laporan ini adalah target dirender sebagai blocks-testing. related-to bersifat simetris. Melengkapi kolom similar_reports yang terdeteksi otomatis yang dikembalikan oleh get_bug_report.
  • classify_bug — Klasifikasikan deskripsi ke salah satu dari 19 jenis laporan (bug, fitur, peningkatan, dll.) dengan skor keyakinan
  • flush_reports — Hapus massal laporan lama (khusus admin)

📊

Penggunaan & Analitik

  • get_usage — Periksa penggunaan terhadap batas paket. Pemanggil kunci API memerlukan usage:read.
  • get_stats — Jumlah harian, rincian jenis/tingkat keparahan/status

📁

Manajemen Proyek

  • list_projects — Daftarkan proyek yang tersedia dengan id, name, slug, ticket_prefix, deskripsi, dan status default. Gunakan nilai-nilai tersebut dengan create_bug_report dan list_bug_reports untuk menargetkan proyek yang benar.
  • create_project — Buat proyek baru (otomatis menjadi default jika pertama)
  • delete_project — Hapus permanen proyek dan semua data terkait (laporan bug, otomasi, kasus uji, aplikasi seluler, jadwal, geo snaps, catatan, entri waktu). Hanya pemilik/manajer. Tidak dapat menghapus proyek terakhir. Penyimpanan dibebaskan secara otomatis
  • export_okf_bundle — Ekspor pengetahuan QA proyek — laporan bug, kasus uji, otomasi, serta pengujian performa, keamanan, dan eksplorasi — sebagai bundel markdown OKF/OQA (format Open Query Agent yang digunakan oleh oqa.ai). Default ke proyek aktif; berikan project opsional (slug atau nama) untuk mengekspor proyek lain. Mengembalikan daftar file dalam bundel plus bundel itu sendiri sebagai zip berenkode base64

🔐

Autentikasi & Akun

  • register_account — Buat akun baru (kata sandi: 8-128 karakter, dibatasi laju: 5/15 menit)
  • login — Masuk dan terima token akses (dibatasi laju: 5/15 menit)
  • update_profile — Perbarui nama tampilan
  • change_password — Ubah kata sandi akun
  • get_settings / update_settings — Kelola preferensi

🔑

Manajemen Kunci API

  • generate_api_key — Buat kunci API bernama
  • list_api_keys — Daftarkan kunci aktif (hanya prefiks)
  • regenerate_api_key — Cabut dan ganti kunci
  • delete_api_key — Cabut kunci secara permanen

👥

Manajemen Tim

  • list_team_members — Daftarkan semua anggota workspace Anda dengan peran, status, dan flag booster
  • invite_team_member — Undang pengguna melalui email (manajer dapat mengundang kontributor dan manajer; hanya pemilik yang dapat mengundang admin). Tautan kedaluwarsa 5 hari

🎯

Integrasi

  • sync_to_jira — Sinkronkan laporan ke Jira menggunakan koneksi bersama tim
  • push_to_claude — Hasilkan (atau hasilkan ulang) Catatan Pengembang untuk laporan bug — akar masalah, perbaikan yang disarankan, langkah verifikasi, dan penilaian risiko. Menerima UUID atau ID pendek (WRKID-545). Menggunakan kunci platform — tidak memerlukan koneksi Claude per tim. Menjalankan rantai adaptif: tiga langkah pada bug s3/medium atau s4/low (draf Sonnet → kritik OpenAI gpt-5 → sintesis Sonnet), lima langkah pada dua kelompok tingkat keparahan teratas — s1/critical atau s2/high — (draf → kritik → sanggahan Sonnet → adjudikator Claude Opus yang membaca seluruh transkrip dan menulis catatan akhir dengan penilaian independen). Respons mengekspos setiap putaran: analysis, draft, critique, rebuttal, challenger_model, adjudicator_model, dan flag debated. Setiap langkah yang gagal jatuh ke jawaban terbaik berikutnya. Terpicu otomatis saat pembuatan bug; biasanya hanya dipanggil untuk regenerasi manual.
  • analyze_fix_area — Hasilkan (atau hasilkan ulang) sub-blok "Area Perbaikan yang Mungkin" dari Catatan Pengembang — keluaran Sonnet yang sempit yang menyebutkan di mana dalam codebase perbaikan paling mungkin berada. Menerima UUID atau ID pendek. Menggunakan kunci Anthropic platform. Ketika tim memiliki baris github_connections dan proyek memiliki github_repo yang dipetakan, keluaran didasarkan pada potongan file nyata dari repo yang terhubung; jika tidak, kembali ke panduan umum dengan dorongan untuk menghubungkan repo. Mengembalikan teks likely_fix_area, generated_at, repo_used, dan flag grounded. Terpicu otomatis saat pembuatan bug — agen biasanya hanya perlu memanggil ini untuk regenerasi manual.
  • upgrade_plan — Dapatkan tautan pendaftaran Enterprise dengan bantuan penjualan

Pengujian Performa

  • create_performance_test — Buat konfigurasi pengujian performa dengan URL, perangkat, pengguna virtual, durasi, ambang skor, dan toggle pembuatan bug otomatis. Khusus Enterprise
  • run_performance_test — Picu audit halaman dan uji beban untuk pengujian performa web. Mengembalikan ID run untuk memeriksa hasil. Run profiling aplikasi seluler dipicu dari dasbor
  • get_performance_results — Dapatkan hasil lengkap termasuk skor Lighthouse (Performa, Aksesibilitas, Praktik Terbaik, SEO), Core Web Vitals (LCP, FID, CLS, FCP, TTFB, INP, TBT, SI), dan metrik uji beban (VU, permintaan, RPS, latensi p50/p90/p95/p99)
  • list_performance_tests — Daftarkan semua konfigurasi pengujian performa untuk tim saat ini
  • get_performance_usage — Periksa penggunaan pengujian performa bulanan. Pengujian performa khusus Enterprise. Gratis=0, Enterprise=tak terbatas

Contoh Alur Kerja

  1. get_performance_usage → periksa kuota tersisa
  2. create_performance_test → konfigurasikan pengujian untuk URL Anda
  3. run_performance_test → picu audit + uji beban
  4. get_performance_results → tinjau skor dan vitals

🛡

Pemindaian Keamanan

  • create_security_scan — Buat konfigurasi pemindaian keamanan. Pemindaian web menggunakan Quick Scanner + Nuclei (4.000+ template) dengan tiga tingkat kedalaman dan opsi pemindaian terautentikasi. Pemindaian seluler menggunakan MobSF untuk analisis biner APK/IPA. Pembuatan bug otomatis yang dapat dikonfigurasi dengan ambang tingkat keparahan. Khusus Enterprise
  • run_security_scan — Picu pemindaian kerentanan. Pemindaian web memerlukan verifikasi domain DNS. Pemindaian seluler memerlukan aplikasi yang diunggah. Mengembalikan ID proses untuk dipantau hasilnya
  • get_security_results — Dapatkan hasil lengkap termasuk skor keamanan (0-100), temuan yang dikategorikan berdasarkan tingkat keparahan (Critical, High, Medium, Low, Info) dengan referensi CWE, pemetaan OWASP, bukti, dan panduan perbaikan
  • list_security_scans — Daftarkan semua konfigurasi pemindaian keamanan untuk tim saat ini dengan skor terakhir dan lencana auth/kedalaman
  • get_security_usage — Periksa penggunaan pemindaian keamanan bulanan. Pemindaian keamanan khusus Enterprise. Enterprise=tanpa batas
  • list_security_schedules — Daftarkan semua pemindaian keamanan terjadwal untuk tim dengan cron, zona waktu, status aktif, proses berikutnya, dan pengaturan notifikasi. Digabungkan dengan konfigurasi pemindaian induk (nama, scan_type, target_url)
  • create_security_schedule — Buat jadwal berulang untuk pemindaian keamanan. Memerlukan scan_id dan cron_expression. Satu jadwal per konfigurasi pemindaian. Opsional timezone, notify_on_fail (none/email/slack/both), notify_email, slack_channel_id. Setiap proses dihitung terhadap kuota bulanan Anda; pengguna admin melewati kuota. Kedalaman pemindaian selalu dibaca dari konfigurasi pemindaian saat proses berjalan
  • delete_security_schedule — Hapus pemindaian keamanan terjadwal. Tidak memengaruhi konfigurasi pemindaian induk atau proses yang telah selesai
  1. get_security_usage → periksa sisa kuota
  2. create_security_scan → konfigurasi pemindaian untuk URL atau repo Anda
  3. run_security_scan → picu pemindaian kerentanan satu kali
  4. create_security_schedule → otomatisasi proses berulang (misalnya SAST mingguan pada branch utama)
  5. get_security_results → tinjau temuan dan perbaikan

📖

Code Review

  • list_code_reviews — Daftarkan tinjauan kode AI terbaru untuk tim. Mengembalikan skor kualitas, jumlah tingkat keparahan, info PR, dan stempel waktu. Khusus Enterprise
  • get_code_review — Dapatkan tinjauan kode dengan semua temuan. Setiap temuan mencakup tingkat keparahan, kategori (bug/security/performance/style/logic/maintainability), judul, deskripsi, saran kode, jalur file, dan nomor baris
  • get_code_review_usage — Periksa penggunaan tinjauan kode. Tinjauan kode AI khusus Enterprise; tanpa batas di Enterprise
  • get_code_review_analytics — Dapatkan analitik tinjauan: tren, kategori/sumber temuan, rincian tingkat keparahan, metrik kecepatan, repo/penulis teratas. Mendukung jangka waktu 7/30/90 hari
  1. get_code_review_usage → periksa sisa tinjauan
  2. Tinjau PR di dasbor di /dashboard/code-review
  3. list_code_reviews → lihat tinjauan terbaru
  4. get_code_review → dapatkan temuan dan saran

🔍

Exploratory AI

Pencari bug situs web otonom multi-agen dengan hingga 10 agen paralel, masing-masing menggunakan strategi pengujian berbeda.

  • list_explorations — Daftarkan konfigurasi Exploratory AI untuk tim
  • create_exploration — Buat eksplorasi baru. Menerima agent_count (1–10, maks 10) untuk menjalankan beberapa agen paralel dengan strategi unik: happy_path, edge_case, security, accessibility, error_path, performance, mobile, data_integrity, navigation, custom
  • get_exploration — Dapatkan konfigurasi eksplorasi dengan pengaturan agen, metadata autentikasi aman, dan proses terbaru. Kata sandi dan ciphertext tidak pernah dikembalikan.
  • get_exploration_run — Dapatkan hasil proses dengan progres per-agen, data fase, temuan dengan atribusi agen (agent_index, agent_strategy), dan bug tertaut
  • get_exploration_usage — Periksa penggunaan bulanan. Exploratory AI khusus Enterprise; Enterprise: tanpa batas (10 agen)
  1. create_exploration dengan agent_count: 5 → konfigurasi 5 agen paralel
  2. Picu proses dari dasbor atau melalui POST /api/explorations/run
  3. get_exploration_run → pantau progres dan temuan per-agen
  4. Lihat temuan yang dideduplikasi dengan atribusi agen di dasbor

📝

Notes

  • list_notes — Daftarkan catatan dengan pencarian kata kunci opsional, filter proyek, filter penulis, dan rentang tanggal. Mengembalikan catatan yang dimiliki pengguna atau catatan bersama dalam tim.
  • create_note — Buat catatan dalam salah satu dari 5 format: markdown, plain_text, rich_text, checklist, outline. Tetapkan visibility ke private atau shared. Judul otomatis dari 30 karakter pertama jika tidak ada judul yang diberikan. Array attachments opsional menerima file berenkode base64 hingga 400 MB masing-masing: gambar, video, audio, PDF, atau teks/JSON apa pun. Berikan time_spent_seconds untuk melacak upaya QA.
  • get_note — Dapatkan detail catatan lengkap termasuk konten dan lampiran. Memerlukan id.
  • update_note — Perbarui judul, konten, format, visibilitas, proyek, atau time_spent_seconds. Berikan array attachments untuk menambahkan file baru (maks 400 MB masing-masing) ke lampiran catatan yang ada tanpa menggantinya. Hanya penulis yang dapat memperbarui. Memerlukan id.
  • delete_note — Hapus permanen catatan dan lampirannya. Hanya penulis yang dapat menghapus. Memerlukan id.
  1. create_note → mulai catatan sesi pengujian
  2. update_note → tambahkan observasi saat Anda menguji
  3. list_notes → cari catatan sebelumnya berdasarkan kata kunci atau proyek
  4. get_note → ambil catatan lengkap dengan lampiran

🤖

Automation

  • create_automation — Buat otomasi baru dengan skrip Playwright kustom (tidak memerlukan rekaman FAB). Memerlukan name. Opsional: target_url (diturunkan otomatis dari URL page.goto(...) pertama dalam skrip jika dihilangkan), script (Node.js/JavaScript/TypeScript atau Python — bahasa terdeteksi otomatis; default ke placeholder), status (draft atau active, default: draft), project_id. Mengembalikan id otomasi. Diperlukan paket Enterprise. Tips — Duplikasi otomasi: gunakan get_automation untuk mengambil skrip asli, lalu panggil create_automation dengan name diatur ke "[Copy] Original Name" dan berikan script, target_url, dan project_id asli. Duplikat dimulai dengan status draft tanpa riwayat versi.
  • list_automations — Daftarkan skrip otomasi Playwright. Filter berdasarkan project_id atau status (draft, active, paused). Mengembalikan array otomasi dengan nama, target_url, last_run_status, dan run_count.
  • get_automation — Dapatkan detail otomasi lengkap termasuk skrip Playwright dan proses terbaru. Memerlukan id. Mengembalikan otomasi dengan script langsung, tumpukan script_versions (terlama-pertama, hingga 100 entri sebelumnya, masing-masing { script, source, timestamp }), dan array recent_runs di mana setiap proses membawa script_version_label/script_version_source yang dieksekusi. Panggil ini sebelum run_automation jika Anda perlu memilih versi historis tertentu.
  • run_automation — Picu proses langsung pengujian Playwright. Memerlukan automation_id. Locator penyembuhan mandiri (otomatis): saat aksi locator mengalami timeout, runner meminta Claude untuk selector yang berfungsi dan mencoba ulang langkah tersebut sekali — asersi tidak pernah disembuhkan, sehingga regresi nyata tetap gagal — dan setiap penyembuhan dicatat di stdout proses. Mode virtual (default): device opsional untuk emulasi viewport (mis. desktop, iphone-15). Mode langsung: atur browserstack: true dengan bs_browser (chrome, firefox, safari, edge), bs_os (Windows, OS X), dan bs_os_version untuk berjalan di browser desktop nyata. Lang sung seluler nyata: atur bs_os: "android" (perangkat: "Samsung Galaxy S25 Ultra", "Google Pixel 10", "OnePlus 13R") atau bs_os: "ios" (perangkat: "iPhone 17 Pro Max", "iPhone 16 Pro Max", "iPhone 15 Pro Max") dan berikan nama perangkat di bs_os_version. Skrip Node.js dirutekan melalui browserstack-node-sdk (mencakup desktop + Android + iPhone). Skrip Python dirutekan melalui browserstack-sdk (pytest-playwright) dan hanya mencakup desktop — seluler nyata melalui Python tidak didukung karena browser_type.connect() pytest-playwright tidak dapat menggerakkan endpoint seluler nyata BrowserStack. Video dan log jaringan direkam otomatis; log konsol hanya desktop. Pemutaran ulang versi: berikan version_index opsional (bilangan bulat, indeks 0) untuk mengeksekusi entri sebelumnya dari riwayat script_versions otomasi. Default: saat version_index dihilangkan atau null, skrip langsung saat ini dijalankan — jangan berikan nilai placeholder hanya untuk "memilih yang saat ini". Nilai di luar rentang, negatif, atau bukan bilangan bulat ditolak. Catatan proses menyimpan snapshot persis yang dijalankan, dan laporan bug apa pun yang dibuat otomatis dari proses yang gagal menautkan kembali ke versi tersebut di editor.
  • list_automation_runs — Daftarkan proses terbaru untuk otomasi. Memerlukan automation_id. Mengembalikan proses dengan status, duration_ms, dan error_message.
  • list_schedules — Daftarkan semua proses otomasi web terjadwal dengan cron, zona waktu, perangkat, dan pengaturan notifikasi
  • create_schedule — Buat proses otomasi web terjadwal. Memerlukan automation_id dan cron_expression. Mendukung perangkat, zona waktu, notify_on_fail (email/slack/both), dan opsi channel Slack. BrowserStack Live pada proses terjadwal: berikan browserstack: true dengan bs_browser, bs_os, dan bs_os_version — matriks perangkat yang sama dengan run_automation (Node = desktop + Android nyata + iPhone nyata; Python = hanya desktop).
  • delete_schedule — Hapus proses otomasi web terjadwal
  • list_mobile_schedules — Daftarkan semua proses otomasi seluler terjadwal dengan perangkat, cron, zona waktu, dan notifikasi
  • create_mobile_schedule — Buat proses otomasi seluler terjadwal di perangkat nyata. Memerlukan automation_id, cron_expression, dan array devices
  • delete_mobile_schedule — Hapus proses otomasi seluler terjadwal
  • optimize_automation_script — Kirim skrip Playwright ke Sonnet 4 untuk optimasi bertenaga AI. Menerapkan daftar periksa 12 poin yang memperbaiki selector, strategi tunggu, asersi, penanganan kesalahan, pola autentikasi, kompatibilitas seluler, dan mode ketat. Memerlukan automation_id. Versi skrip saat ini disimpan sebelum optimasi. Mengembalikan skrip yang dioptimalkan dan ringkasan perubahan.
  • undo_automation_script — Kembalikan skrip otomasi ke versi sebelumnya. Hingga 10 versi sebelumnya disimpan. Memerlukan automation_id. Mengembalikan skrip yang dipulihkan dan jumlah versi yang tersisa.
  1. create_automation → buat pengujian dengan skrip kustom
  2. list_automations → jelajahi pengujian yang tersedia
  3. get_automation → periksa skrip Playwright
  4. run_automation → picu pengujian
  5. list_automation_runs → periksa hasil dan durasi

⏱️

Time Tracking

  • list_time_entries — Daftarkan entri waktu untuk tim. Filter berdasarkan period (today, week, month, all), project_id, category, dan sort (newest, oldest, most_time, least_time). Hanya paket Enterprise.
  • create_time_entry — Catat waktu yang dihabiskan untuk tugas QA. Memerlukan description, category, dan duration_minutes. Opsional menetapkan project_id dan entry_date (default ke hari ini). Hanya paket Enterprise.
  • update_time_entry — Perbarui entri waktu yang ada. Memerlukan id. Dapat memperbarui description, category, duration_minutes, project_id, atau entry_date. Hanya paket Enterprise.
  • delete_time_entry — Hapus permanen entri waktu. Memerlukan id. Hanya paket Enterprise.
  1. create_time_entry → catat 45 menit pengujian regresi
  2. list_time_entries → lihat entri waktu minggu ini
  3. update_time_entry → sesuaikan durasi atau kategori
  4. delete_time_entry → hapus entri yang salah

☑️

Test Cases

Manajemen Pengujian, Suite & Laporan

Manajemen pengujian dengan folder hierarkis, suite bersarang (hingga 3 level dengan perluasan otomatis sub-suite saat dijalankan), urut ulang drag-drop, dan tab Laporan analitik dengan tren KPI, analisis kegagalan, kesehatan suite, cakupan, dan produktivitas penguji. Semua alat memanggil Supabase secara langsung — tanpa roundtrip HTTP, dengan latensi yang sama seperti dasbor.

Batas Free: 10 kasus pengujian tersimpan, 1 suite, 3 folder, 128 KB konten terstruktur per kasus, 2 kunci API workspace aktif, dan total 10 run pengujian per bulan kalender UTC. Hingga 3 dari run tersebut dapat menggunakan Hermes atau agen eksternal lainnya, dengan 1 run eksternal aktif dan maksimal 10 kasus di setiap rencana eksternal. Lalu lintas MCP kunci API Free dibatasi hingga 30 permintaan per kunci dan 60 per workspace per menit. Penyimpanan kasus pengujian dan run Enterprise tidak terbatas, dengan tunduk pada perlindungan platform umum.

Pembuatan kasus uji AI, saran tag AI, impor Figma, dan lampiran berkas kasus uji memerlukan Enterprise. Batas konten terstruktur Free 128 KB terpisah dari lampiran berkas Enterprise. Free dapat menyimpan referensi URL. Alat MCP kasus uji inti tetap tersedia di Free dalam batas di atas.

Eksekusi hands-free: halaman tinjauan run adalah korsel dengan satu kasus terlihat pada satu waktu, pintasan keyboard (P Pass · F Fail · B Block · S Skip), dan kontrol suara. Klik mikrofon, lalu ucapkan "Pass", "Fail", "Block", "Skip", "Next", "Previous", "Add notes" (ditranskripsikan ke kolom catatan), "Save notes", atau "Voice off". Otomatis maju ke kasus yang belum diuji berikutnya pada hasil sukses; tetap di tempat pada Fail sehingga penguji dapat mendikte detail dan membuat bug. Berfungsi di Chrome, Edge, dan Safari.

Kasus & Folder
  • list_test_cases — Daftar kasus pengujian dengan opsi search, priority (critical, high, medium, low), type (functional, regression, smoke, integration, performance, security, usability, exploratory), status (active, draft, deprecated), dan sort (newest, oldest, name, priority). Pemanggil kunci API memerlukan test_cases:read.
  • create_test_case — Buat kasus pengujian. Dua varian templat: steps (default) — grid { action, expected } per langkah melalui array steps; text — satu deskripsi bebas melalui text_content. Kedua kolom dapat dikirim dalam panggilan yang sama (platform menyimpannya secara independen sehingga penguji yang mengganti template_type nanti tidak kehilangan data dari salah satu sisi). Opsional array urls (maks. 10 URL http/https) melampirkan tautan referensi dan tersedia di Free. Memerlukan name. Opsional: description, preconditions, template_type, steps, text_content, urls, priority, type, tags, estimated_time (detik). Lampiran berkas memerlukan Enterprise dan diunggah melalui endpoint POST /api/test-cases/:id/attachments dasbor (multipart) — belum diekspos sebagai alat MCP. Pemanggil kunci API memerlukan test_cases:write.
  • get_test_case — Ambil detail kasus pengujian lengkap termasuk langkah-langkah dan riwayat eksekusi.
  • list_test_case_folders — Daftar folder tim (satu folder per kasus melalui folder_id; berbeda dari suite, yang merupakan pengelompokan rencana pengujian banyak-ke-banyak). Dibatasi hingga 500; menghormati filter project_id dan parent_folder_id (gunakan "root" untuk hanya tingkat teratas).
  • create_test_case_folder — Buat folder (bersarang hingga 3 level melalui parent_folder_id). Gunakan bulk_update_test_cases untuk memindahkan kasus ke dalamnya. Pemanggil kunci API memerlukan test_cases:write.
  • bulk_update_test_cases — Terapkan satu tindakan ke hingga 500 kasus sekaligus: set_priority, set_status, set_type, add_tags, remove_tags, add_to_suite, pin, unpin.
  • link_test_case_to_bug — Bangun keterlacakan antara kasus pengujian dan laporan bug (verified_by, covers, atau relates).
  • list_test_case_links — Daftar semua tautan keterlacakan untuk kasus pengujian.
  • list_test_case_review_candidates — Bendera kasus mati: never_run (90+ hari sejak pembuatan), always_passes (5+ kelulusan berurutan dalam 90 hari), always_skipped (3+ lompatan berurutan).
  • mark_test_case_review_flags — Pertahankan bendera kandidat arsip saat ini ke test_cases.review_flag. Berjalan otomatis setiap Senin 09:00 UTC melalui pg_cron.
Impor
  • Impor Figma (Enterprise) (UI dasbor + REST): unggah ekspor zip bingkai Figma (hingga 100 MB), Claude menganalisis setiap layar dan menyusun kasus pengujian ke dalam folder yang Anda pilih atau buat. Pipeline multi-tahap (klasifikasi → kasus per layar → kasus tingkat alur di seluruh layar dengan prefiks bersama → kritik diri) dengan cache prompt, percobaan ulang 429, dan isolasi kesalahan per bingkai sehingga satu bingkai yang buruk tidak menggagalkan batch. Kasus masuk sebagai status=active, diberi tag ai_generated=true, dengan source='figma' dan source_frame_name yang mempertahankan tautan ke bingkai asli. Menggunakan kunci Anthropic platform — tidak memerlukan koneksi Claude per tim. Endpoint: POST /api/test-cases/import/figma/request, POST /api/test-cases/import/figma/start, GET /api/test-cases/import/figma/:id.
Suite & Run
  • list_test_suites — Daftar suite pengujian dengan identitas proyek, jumlah kasus, dan status run terakhir. Pemanggil kunci API memerlukan test_runs:read.
  • create_test_suite — Buat suite. Bersarang hingga 3 level melalui parent_suite_id.
  • list_test_runs — Daftar run pengujian dengan nama suite, penanggung jawab, dan ringkasan lulus/gagal.
  • create_test_run — Buat run suite yang dikelola dasbor. Menjalankan suite induk secara otomatis menyertakan setiap kasus di setiap sub-suite turunan (kasus yang ditautkan ke keduanya ditambahkan tepat satu kali). Setiap baris test_run_results mencatat dari sub-suite asal mana kasus tersebut berasal, sehingga halaman hasil dapat dikelompokkan berdasarkan asal.
Eksekusi Agen Eksternal

Alat-alat ini memungkinkan Hermes atau runtime agen lain mengeksekusi suite yang disetujui tanpa menjadi sistem pencatatan QA. Gunakan kunci dengan cakupan workspace yang hanya memiliki test_runs:read dan test_runs:write. Suite menyediakan batas proyek; pemanggil tidak dapat menimpa batas tersebut.

  • start_test_plan — Mulai atau lanjutkan snapshot suite yang tidak dapat diubah dengan external_run_id yang stabil. ID berulang mengembalikan run yang cocok dan halaman pertama yang sudah ada alih-alih membuat duplikat.
  • get_test_run_plan — Baca status run kanonik dan halaman rencana yang stabil. Berikan next_cursor sebelumnya; halaman default 100 kasus dan dibatasi maksimal 200.
  • report_test_results — Kirim 1–200 hasil dengan status passed, failed, blocked, atau skipped. Percobaan ulang yang persis aman; mencoba menimpa kasus dengan status lain ditolak.
  • abort_test_run — Hentikan run yang terinterupsi secara idempoten sambil mempertahankan hasil parsial yang diterima dan ringkasan kanonik.

Perilaku kuota: percobaan ulang start_test_plan dengan external_run_id yang sama untuk melanjutkan run yang cocok tanpa menghabiskan run lain. Menghapus data tidak mengatur ulang penggunaan run bulanan.

Batas runtime: snapshot kasus mengecualikan kredensial, isi berkas, dan jalur lampiran pribadi. Bukti hasil berupa teks di MVP. Kredensial target tetap berada di runtime eksekusi. Biaya browser, model, dan jaringan tetap di sisi pelanggan, dan pelanggan harus membatasi akses target dan lalu lintas keluar jaringan. Manusia tetap bertanggung jawab atas keputusan cacat dan rilis.

Panduan Agen Hermes mengemas siklus ini sebagai skill komunitas yang dikelola bugAgent. Kit pemula publik berisi konfigurasi siap salin dan skill yang dapat diinstal. Ini bukan integrasi resmi Nous Research.

Laporan (Analitik Tier 1 + Tier 4)
  • get_test_reports_overview — KPI utama untuk rentang waktu (tingkat kelulusan, run selesai, kasus dieksekusi) dengan delta vs rentang waktu setara sebelumnya. Angka yang sama dengan strip KPI di tab Laporan.
  • get_test_reports_failures — Empat daftar "apa yang perlu diperbaiki?": failing_cases (≥50% gagal, min. 3 run), flaky_cases (paling banyak perubahan lulus/gagal), failing_suites (≥30% gagal, min. 5 run), regressed_cases (kegagalan terbaru dengan kelulusan sebelumnya dalam rentang waktu).
  1. create_test_case_folder → buat pohon folder (mis. Smoke → Auth)
  2. create_test_case → tentukan kasus; pindahkan ke folder dengan bulk_update_test_cases
  3. create_test_suite → bangun rencana pengujian (sub-suite opsional, hingga 3 level kedalaman)
  4. create_test_run → buat run yang dikelola manusia/dasbor dari suite induk — sub-suite otomatis disertakan
  5. start_test_plan → mulai atau lanjutkan run agen eksternal yang aman terhadap percobaan ulang
  6. get_test_run_plan → ambil setiap halaman rencana yang tidak dapat diubah, lalu eksekusi di runtime yang dipilih
  7. report_test_results → kembalikan batch hasil yang dibatasi; panggil abort_test_run jika eksekusi tidak dapat dilanjutkan dengan aman
  8. get_test_reports_failures → tanyakan "apa yang perlu diperbaiki minggu ini?" setelah run selesai
  9. get_test_reports_overview → lacak tren tingkat kelulusan minggu demi minggu

Penguat Tim

  • scale_team — Tingkatkan tim QA Anda secara instan dengan penguji penguat. Akun disediakan secara otomatis dengan akses penguji. Tentukan team_size (1–10), location, duration, budget, dan opsional product_url, product_types, dan tech_levels. Tersedia pada paket Enterprise. Anda tidak akan ditagih sampai persetujuan diberikan.
  1. scale_team → sediakan 5 penguji senior di AS selama 1 bulan
  2. list_team_members → verifikasi penguji baru muncul di tim Anda
  3. list_reports → tinjau laporan yang diajukan oleh penguji penguat

📱

Pengujian Seluler (Enterprise)

Sumber daya seluler memiliki cakupan proyek. Berikan project_id atau pemilih project yang fleksibel pada pembuatan, impor, dan daftar yang difilter. Otomatisasi mewarisi proyek aplikasi yang ditautkan; jika tidak, server menggunakan proyek default workspace. Daftar yang tidak difilter mungkin masih menyertakan baris tingkat workspace lama hingga dimigrasikan.

  • list_mobile_apps — Daftar aplikasi yang diunggah dengan filter opsional project_id/project, platform, dan limit. Mengembalikan project_id setiap aplikasi sehingga agen dapat menjaga operasi selanjutnya dalam proyek yang sama.
  • upload_mobile_app — Daftarkan aplikasi APK (Android) atau IPA (iOS) untuk pengujian pada perangkat nyata. Memerlukan name, platform (android/ios), dan file_url; berikan project_id untuk menetapkannya ke proyek aktif. Untuk iOS, unggah IPA untuk menjalankan perangkat nyata, lalu gunakan dasbor untuk mengunggah build simulator .app untuk perekaman.
  • update_mobile_app — Ganti biner aplikasi dengan versi baru. Menghapus URL cache dan build simulator sehingga semua otomasi menggunakan versi baru pada proses berikutnya. Memerlukan app_id dan file_url. Opsional: version. Jika otomasi tertaut menggunakan profil login, pemanggil harus memiliki otorisasi untuk setiap profil atau menjadi pemilik/admin ruang kerja aktif; jadwal mewarisi default otomasi yang dilindungi.
  • list_mobile_automations — Daftar otomasi seluler dengan filter opsional project_id/project, app_id, status, dan limit. Hasil mencakup project_id dan ID aplikasi tertaut.
  • create_mobile_automation — Buat skrip pengujian. Memerlukan name, app_id, script_type (maestro untuk YAML, appium untuk Appium Python, appium_js untuk Appium JavaScript), dan script; berikan project_id saat aplikasi belum memiliki cakupan proyek. Untuk satu alur Maestro YAML yang tervalidasi eksternal dan mandiri, atur execution_mode ke browserstack_maestro; jika tidak, defaultnya adalah appium_actions. appId YAML harus cocok dengan paket atau ID bundel yang tersimpan dari aplikasi tertaut; jika tidak ada yang tersimpan, alur native tervalidasi pertama yang menetapkannya. ID aplikasi placeholder dan ID sumber daya Android yang diobfuskasi ditolak. runFlow inline didukung, tetapi referensi file alur/skrip eksternal ditolak di v1. Maestro native mempertahankan perintah seperti inputRandomText dan copyTextFrom serta ekspresi runtime seperti ${maestro.copiedText} dan ${output.value}. credential_id dalam proyek yang sama dapat menyediakan nilai inputText lengkap dari ${USERNAME}/${PASSWORD}. variable_profile_id dalam proyek yang sama dapat menyimpan default untuk nilai ${DATA_*} yang direferensikan; setiap kunci yang direferensikan harus ada. Profil data hanya berisi data sintetis non-rahasia.
  • import_mobile_script — Impor skrip pengujian seluler yang ada dan ubah menjadi otomasi yang dapat dijalankan, mempertahankan lokator milik pengembang sehingga proses berjalan menyelesaikan elemen secara presisi. Dialek yang didukung: Appium‑Python, WebdriverIO, Maestro (alur YAML), dan Playwright (seluler‑web). Placeholder ID sumber daya Android yang diobfuskasi dilewati dan dilaporkan dalam pemetaan selektor warnings. Hanya aplikasi Android. Memerlukan name, app_id, dan script; opsional target_devices dan project_id. Mengembalikan otomasi beserta action_count, dialect yang terdeteksi, dan pemetaan selektor warnings.
  • run_mobile_automation — Mulai otomasi seluler pada perangkat nyata. Memerlukan automation_id; opsional device, os_version, credential_id, dan variable_profile_id Maestro native. Untuk data, hilangkan variable_profile_id untuk mewarisi default otomasi, berikan null untuk tidak menggunakan profil, atau berikan UUID dalam proyek yang sama untuk menimpa. Setiap kunci ${DATA_*} yang direferensikan harus ada. Hanya pembuat profil aktif atau pemilik/admin ruang kerja aktif yang dapat mengeksekusi profil terpilih. Nilai kredensial yang diketahui persis difilter dan nilai profil data yang persis menerima penyaringan upaya terbaik dari bukti tekstual yang disimpan; nilai data yang diubah, sebagian, dienkode, atau berasal dari aplikasi mungkin tetap ada. Video/tangkapan layar pribadi yang diotorisasi tetap tersedia dan mungkin menampilkan nilai yang dirender oleh aplikasi yang diuji, sehingga profil data hanya boleh berisi nilai sintetis non-rahasia. Jika konteks redaksi kredensial tidak tersedia atau sanitasi tidak dapat dibuktikan aman, teks berisi kredensial yang terperinci ditahan sementara status dan bukti visual yang tersedia tetap ada. Diagnostik memerlukan otorisasi ruang kerja dan proyek; tautan media kedaluwarsa setelah lima menit.
  • list_mobile_runs — Dapatkan hasil proses seluler yang diotorisasi (status, perangkat, ringkasan hasil, tautan video dan tangkapan layar pribadi, sesi BrowserStack, log Maestro native berisi kredensial yang difilter dan kegagalan saat tersedia dengan aman, serta bug yang dibuat otomatis). Keanggotaan ruang kerja dan akses proyek diberlakukan untuk diagnostik proses. Filter opsional: project_id, automation_id, status (queued, running, passed, failed, error, archived), dan limit. Proses yang diarsipkan dikecualikan secara default.
  • create_mobile_credential — Buat profil login bernama (mis. “Admin”, “Kontributor”) untuk sebuah proyek: nama pengguna + kata sandi yang digunakan oleh otomasi seluler. Kedua nilai disimpan terenkripsi AES‑256‑GCM dan bersifat hanya-tulis — tidak ada alat atau API yang pernah mengembalikannya, dan anggota lain / UI hanya melihat nama. Hanya anggota ruang kerja aktif yang membuatnya atau pemilik/admin ruang kerja aktif yang dapat mengikat, menjalankan, memutar, atau menghapusnya. Memerlukan project_id, name, username, password. Khusus Enterprise.
  • list_mobile_credentials — Daftar profil login (opsional satu project_id). Mengembalikan hanya bidang non‑rahasia (id, name, proyek, pembuat, tanggal dibuat) — tidak pernah nama pengguna atau kata sandi. Gunakan id yang dikembalikan sebagai pilihan kredensial saat menjalankan otomasi.
  • update_mobile_credential — Ubah nama profil login atau putar nama pengguna/kata sandinya dengan id. Sertakan hanya bidang yang akan diubah. Nilai rahasia baru dienkripsi segera dan tidak pernah dikembalikan. Hanya anggota ruang kerja aktif yang membuat profil atau pemilik/admin ruang kerja aktif yang dapat memperbaruinya.
  • delete_mobile_credential — Hapus lunak profil login dengan id. Hanya anggota ruang kerja aktif yang membuat profil atau pemilik/admin ruang kerja aktif yang dapat menghapusnya. Profil dipertahankan untuk audit dan riwayat proses tetapi tidak lagi dapat digunakan atau didaftarkan; default otomasi dibersihkan dan nama menjadi dapat digunakan kembali.
  • create_mobile_variable_profile — Buat data uji sintetis yang dapat digunakan kembali dengan cakupan proyek menggunakan project_id, name, dan objek variables seperti {"DATA_EMAIL":"qa@example.test","DATA_REGION":"ca"}. Kunci harus berupa pengidentifikasi DATA_* huruf besar. Profil mengizinkan 1–100 string, 4096 byte UTF-8 per nilai, dan total 65536 byte. Nama kredensial/waktu proses yang dicadangkan ditolak. Jangan pernah menyimpan kredensial, token, data pribadi produksi, atau rahasia lainnya.
  • list_mobile_variable_profiles — Daftar profil dan nilai non-rahasia yang dapat dibaca untuk satu project_id yang diotorisasi. Aturan penugasan proyek berlaku.
  • update_mobile_variable_profile — Ubah nama profil atau ganti objek variables lengkapnya dengan id. Hanya pembuat aktif atau pemilik/admin ruang kerja aktif yang dapat memperbaruinya.
  • delete_mobile_variable_profile — Hapus lunak profil dengan id. Hanya pembuat aktif atau pemilik/admin ruang kerja aktif yang dapat menghapusnya; default otomasi dibersihkan sementara referensi proses historis tetap ada.
  • list_mobile_schedules, create_mobile_schedule, delete_mobile_schedule — Daftar, buat, dan hapus jadwal perangkat nyata. Jadwal mewarisi konteks proyek, profil login, dan profil variabel non-rahasia dari otomasi yang dipilih. Jadwal yang menggunakan salah satu profil yang dilindungi memerlukan pembuat profil aktif atau pemilik/admin ruang kerja aktif; perubahan dan penghapusan jadwal dibatasi untuk pembuat jadwal aktif atau pemilik/admin ruang kerja aktif.

Contoh Alur Kerja — Android

  1. list_projects → selesaikan project_id target
  2. upload_mobile_app → daftarkan APK di proyek tersebut
  3. Rekam dengan aman di dasbor, atau gunakan import_mobile_script / create_mobile_automation
  4. list_mobile_automations → selesaikan otomasi di proyek yang sama
  5. run_mobile_automation → picu di perangkat nyata, opsional dengan profil login
  6. list_mobile_runs → periksa status, ringkasan hasil, tautan visual pribadi, dan metadata sesi BrowserStack
  7. Kegagalan membuat laporan bug secara otomatis dengan snapshot kegagalan dan rincian langkah

Contoh Alur Kerja — iOS

  1. upload_mobile_app → daftarkan IPA Anda dengan project_id untuk proses perangkat nyata
  2. Unggah build simulator .app di halaman detail aplikasi (untuk perekaman)
  3. Rekam pengujian di browser → tindakan ditangkap dari simulator
  4. run_mobile_automation → picu otomasi yang disimpan di iPhone (menggunakan IPA)
  5. update_mobile_app → ganti IPA dengan versi baru saat siap

Contoh Alur Kerja — Maestro Native

  1. upload_mobile_app → daftarkan APK atau IPA di proyek target
  2. create_mobile_credential → opsional buat profil dalam proyek yang sama untuk alur terautentikasi
  3. create_mobile_variable_profile → opsional buat nilai DATA_* sintetis dalam proyek yang sama yang digunakan oleh alur
  4. create_mobile_automation → berikan satu alur YAML yang diketahui berfungsi dengan paket/bundel appId yang tepat dari aplikasi tertaut, script_type: maestro, dan execution_mode: browserstack_maestro. Gunakan ${USERNAME}/${PASSWORD} untuk login dan placeholder gaya ${DATA_EMAIL} untuk input sintetis; berikan ID profil untuk menyimpan default.
  5. run_mobile_automation → pilih perangkat yang kompatibel dan opsional timpa profil login atau variabel. Hilangkan profil variabel untuk mewarisi, atau berikan null untuk menonaktifkannya untuk satu proses.
  6. list_mobile_runs → periksa ringkasan lulus/gagal yang diotorisasi, video/tangkapan layar pribadi, log yang difilter, nama langkah asli, kegagalan terperinci, dan metadata sesi. Jika sanitasi aman tidak dapat ditetapkan untuk proses berisi kredensial, teks terperinci ditahan sementara status dan bukti visual yang tersedia tetap ada.

Sempurnakan dengan AI: beta yang masuk daftar izin tersedia melalui dasbor dan titik akhir penyempurnaan REST. Belum ada alat Refine MCP yang menjadi bagian dari katalog publik.

Kepatuhan & Bukti (Enterprise)

  • collect_compliance_evidence — Picu pengumpulan bukti otomatis dari layanan terhubung (Cloudflare, GitHub, Sentry, Supabase, Railway). Mengembalikan ID proses. Mengumpulkan pengaturan SSL/TLS, status WAF, peringatan Dependabot, tren kesalahan, riwayat deploy, dan lainnya.
  • check_config_drift — Periksa semua layanan terhubung untuk penyimpangan konfigurasi keamanan dari baseline (mode SSL, versi TLS, HSTS, aturan WAF, header keamanan).
  • generate_access_review — Buat laporan tinjauan akses triwulanan. Mengaudit anggota tim, peran, status MFA, penggunaan kunci API, dan menghasilkan rekomendasi (mis., cabut kunci yang tidak aktif).
  • get_security_events — Kueri garis waktu peristiwa keamanan lintas layanan. Filter berdasarkan sumber (cloudflare, sentry, github) dan tingkat keparahan (kritis, tinggi, sedang, rendah, info). Peristiwa dikorelasikan secara otomatis di seluruh layanan.

Cakupan Kepatuhan

Alat-alat ini membantu memenuhi persyaratan kepatuhan SOC2 (CC4.1, CC6.1, CC7.2, CC8.1), ISO 27001 (A.5.18, A.8.8, A.8.9, A.8.15-16, A.8.29), dan GDPR (Art. 5, 25, 32, 33).

Klien yang Kompatibel

bug_Agent_ bekerja dengan klien apa pun yang mendukung Model Context Protocol. Berikut panduan pengaturan untuk klien populer:

🤖

Claude Desktop

Buka Pengaturan → Pengembang → Edit Konfigurasi, lalu tambahkan:

claude_desktop_config.json

Mulai ulang Claude Desktop setelah menyimpan.

✳️

Cursor

Buka Pengaturan → Server MCP → Tambah Server, atau edit .cursor/mcp.json di akar proyek Anda:

.cursor/mcp.json

🌊

Windsurf

Buka Pengaturan → MCP → Tambah Server, atau edit file konfigurasi MCP Anda:

mcp_config.json

💻

Claude Code (CLI)

Tambahkan bug_Agent_ langsung dari terminal:

claude mcp add bugagent -- npx -y @bugagent/mcp-server

Atur kunci API Anda dengan export BUGAGENT_API_KEY=ba_live_... sebelum meluncurkan.

🔧

Klien MCP Lainnya

Klien apa pun yang mendukung transport stdio MCP berfungsi dengan bug_Agent_. Gunakan konfigurasi standar:

  • Perintah: npx
  • Argumen: ["-y", "@bugagent/mcp-server"]
  • Lingkungan: BUGAGENT_API_KEY

CLI

Memulai dengan CLI

CLI bug_Agent_ memberi Anda kendali penuh atas laporan bug, permintaan fitur, proyek, dan integrasi dari terminal Anda. Gunakan untuk:

  • Otomatiskan alur kerja — Integrasikan pelaporan bug ke dalam pipeline CI/CD, skrip, dan cron jobs
  • Operasi massal — Daftar, filter, dan kelola laporan tanpa meninggalkan terminal
  • Output ramah-pipe — Format JSON, YAML, dan mentah untuk disusun dengan jq, yq, dan alat lainnya
  • Iterasi cepat — Tanpa browser — buat dan perbarui laporan dalam hitungan detik

Instalasi

npm install -g @bugagent/cli

Verifikasi instalasi:

bugagent --version

Autentikasi

Atur kunci API Anda sebagai variabel lingkungan:

Atau berikan langsung dengan flag --api-key:

bugagent reports list --api-key ba_live_your_key_here

🔑

Dapatkan kunci API Anda dari konsol bug_Agent_. Kunci dimulai dengan ba_live_.

Untuk autentikasi persisten, tambahkan export ke profil shell Anda (~/.bashrc, ~/.zshrc, dll.).

Penggunaan

Perintah mengikuti pola:

bugagent <resource> <action> [flags]

Sumber daya juga dapat menggunakan sintaks titik dua untuk sub-sumber daya:

bugagent reports comments add --report-id WRKID-545 --body "Reproduced on v2.1"

Gunakan --help pada perintah apa pun untuk detail:

bugagent reports --help
bugagent reports create --help

Contoh Sesi

Terminal

# List your projects
bugagent projects list

# Create a bug report in your default project
bugagent reports create \
  --title "Checkout 500 on discount code" \
  --description "Applying SAVE20 returns HTTP 500" \
  --severity critical \
  --type logic

# View recent reports
bugagent reports list --limit 5 --format pretty

# Get full details on a report (use the short ID or UUID)
bugagent reports get WRKID-545

# Sync a report to Jira
bugagent jira sync --report-id WRKID-545

# Check your usage
bugagent usage get --format json

Fitur CLI

CLI menyediakan perintah untuk:

reports Buat, daftar, dapatkan, perbarui, dan flush laporan bug projects Buat, daftar, perbarui, dan hapus proyek keys Hasilkan, daftar, hasilkan ulang, dan cabut kunci API jira Hubungkan, sinkronkan laporan, dan konfigurasikan pengaturan Jira usage Periksa penggunaan saat ini terhadap batas paket stats Lihat analitik dan rincian profile Lihat dan perbarui profil dan pengaturan Anda auth Masuk, daftar, dan kelola kredensial

Flag Global

Deskripsi Flag

--api-key <key> Ganti kunci API untuk perintah ini

--format <fmt> Format output: json, yaml, pretty, raw

--debug Tampilkan detail permintaan/respons untuk pemecahan masalah

--help Tampilkan bantuan untuk perintah apa pun

--version Cetak versi CLI

Format Output

CLI mendukung beberapa format output untuk berbagai kasus penggunaan:

json

JSON yang dapat dibaca mesin. Ideal untuk disalurkan ke jq atau alat lainnya.

yaml

Output YAML yang ramah manusia untuk file konfigurasi dan keterbacaan.

pretty

Default. Output berwarna dan terformat yang dirancang untuk terminal.

raw

Output tanpa format. Berguna untuk skrip dan otomatisasi.

Pemfilteran dengan --transform

Gunakan --transform dengan sintaks GJSON untuk meminta dan memfilter data output:

# Default pretty output
bugagent reports list

# JSON for piping to other tools
bugagent reports list --format json

# YAML
bugagent reports list --format yaml

# Raw (no formatting)
bugagent reports get rpt_abc123 --format raw

# Filter with GJSON syntax
bugagent reports list --format json \
  --transform "items.#(severity==critical).title"

Keterampilan AI

CLI juga tersedia sebagai AgentSkill, memungkinkan asisten pengkodean AI menggunakan bug_Agent_ atas nama Anda.

Apa itu AgentSkill?

AgentSkills memungkinkan asisten pengkodean AI (Claude Code, Cursor, dll.) memanggil alat CLI secara kontekstual. Keterampilan bug_Agent_ memberi asisten AI Anda kemampuan untuk mengajukan bug, memeriksa status proyek, dan sinkron ke Jira — semuanya tanpa Anda mengetik perintah.

Instal Skill

claude skills install bugagent --from @bugagent/mcp-server

Setelah terinstal, Asisten AI yang sadar konteks dapat menggunakan perintah bug_Agent_ secara alami — dengan pengetahuan penuh tentang produk Anda, panduan pengujian, dan dokumentasi yang diunggah:

Prompt Asisten AI

"File a critical bug: the payment webhook is returning
a 403 after the latest deploy. It affects all Stripe
events. Assign it to the payments project."

Keterampilan ini menerjemahkan bahasa alami menjadi perintah CLI yang sesuai dan mengeksekusinya.

🎬

Session Replay + Asisten AI: Saat Session Replay diaktifkan (paket Enterprise), Asisten AI dapat merujuk sesi pengguna yang ditangkap — klik, navigasi, kesalahan, dan kegagalan jaringan dari 60 detik terakhir — untuk menyusun draf otomatis laporan bug yang lebih kaya dan lebih akurat dengan konteks reproduksi lengkap.

Dapatkan Bantuan

Butuh bantuan? Kami siap membantu.

Komunitas Discord

Bergabunglah dengan Discord kami untuk dukungan real-time dan diskusi komunitas.

Dukungan Email

support@bugagent.com — Kami biasanya merespons dalam 24 jam.