Patricia

[!NOTE] Repositori ini dibuat dari bettergroupinc/patricia-monorepo pada plugins/patricia/. Otomatisasi menyinkronkan cermin publik ini. Komit sumber: 147037702592109a4944cdbfb94bdcabb33f490f. Buka pull request dan issue di monorepo.

Plugin Claude Code patricia

Pasang ini sekali dan agen akan menggunakan server MCP Patricia dengan benar tanpa perlu diberi tahu lagi.

Plugin ini membawa tiga hal.

1. Panduan. Lima keterampilan mencakup dasar-dasar Patricia, orientasi, pekerjaan yang didelegasikan, integrasi, dan jembatan memori.
2. Koneksi MCP. Instalasi mengonfigurasi server Streamable HTTP Patricia untuk masuk dengan OAuth.
3. Lima hook lokal. Mereka mengorientasikan proyek, memanggil memori, memeriksa integrasi terlebih dahulu, dan mengusulkan dorongan memori. Mereka tidak pernah menulis ke Patricia.

Ini adalah plugin Claude Code yang dapat didistribusikan. Seseorang memasangnya di mesin mereka sendiri, dan plugin ini berjalan di sesi Claude Code orang tersebut. Ini bukan katalog keterampilan produk Patricia, dan tidak ada apa pun di dalamnya yang berjalan di dalam Patricia.

Instalasi

claude plugin marketplace add patricia-app/patricia-plugin
claude plugin install patricia@patricia

Lalu mulai sesi baru, atau jalankan /reload-plugins.

Marketplace itu adalah https://github.com/patricia-app/patricia-plugin. Otomatisasi menghasilkan setiap file di dalamnya dari monorepo Patricia.

Catatan kontributor: monorepo bersifat privat. Kontributor dengan akses dapat menambahkan monorepo itu sendiri sebagai marketplace, karena .claude-plugin/marketplace.json akarnya menunjuk plugin patricia ke ./plugins/patricia.

Instal. Jangan memuatnya dengan --plugin-dir. Plugin yang dimuat dari direktori mendapatkan keterampilannya dan bukan hook-nya, sehingga panduan akan berfungsi dan jembatan memori tidak akan pernah aktif. Itu diukur bukan diasumsikan: hook probe yang dimuat melalui --plugin-dir tidak pernah berjalan, sementara hook yang sama dideklarasikan di pengaturan proyek berjalan pada penulisan yang sama dalam mode headless yang sama. Claude Code mendaftarkan hooks/hooks.json plugin hanya untuk plugin yang terinstal dan diaktifkan.

claude plugin details patricia melaporkan apa yang masuk:

Component inventory
  Skills (5)  delegating-work, integrations, memory-bridge, onboard, using-patricia
  MCP servers (1)  patricia
  Hooks (5)  SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop

Masuk ke server MCP

Plugin mengonfigurasi server MCP tanpa header tersimpan. Pada penggunaan pertama, jalankan /mcp dan pilih Patricia. Anda juga dapat memulai alur OAuth dari terminal:

claude mcp login plugin:patricia:patricia

Masuk OAuth MCP dan token pribadi pat_mcp_ dari hook adalah kredensial terpisah. OAuth saja tidak mengaktifkan hook yang bergantung pada token.

Gunakan token sebagai alternatif saat OAuth tidak cocok:

claude mcp add --transport http patricia https://api.patricia.app/v1/mcp \
  --header "Authorization: Bearer $PATRICIA_MCP_TOKEN"

Token pribadi pat_mcp_ menyebutkan orang yang bertanggung jawab dan dapat menulis. Kunci API penyewa pat_live_ tidak menyebutkan siapa pun, sehingga hanya dapat membaca, dan tidak dapat menjawab list_skills atau list_integrations.

Berikan token pribadi ke hook lokal

Python 3 harus tersedia melalui perintah python3 untuk hook lokal.

Buat kunci pribadi pat_mcp_ di Patricia di bawah Pengaturan > Pengembang > Kunci pribadi. Lalu pilih salah satu pengaturan:

export PATRICIA_MCP_TOKEN="pat_mcp_..."

Atau tulis file ini di ~/.claude/patricia.json:

{
  "token": "pat_mcp_..."
}

PATRICIA_MCP_TOKEN menang atas file. PATRICIA_MCP_TOKEN kosong menonaktifkan fallback file. Perilaku ini disengaja. Ini memungkinkan seseorang menangguhkan hook yang terautentikasi tanpa memindahkan file.

Hook lokal

Semua lima hook aktif secara default. File konfigurasi yang tidak ada atau kunci hook yang tidak ada membuatnya tetap aktif. Konfigurasi yang rusak atau tidak dapat dibaca mematikannya. Setel kunci yang terdaftar dari hook ke nilai literal false di ~/.claude/patricia-plugin.json untuk mematikan hanya hook itu.

Orientasi

• Kapan dan tindakan: SessionStart berjalan untuk sesi baru atau yang dilanjutkan. Ini menyapa orang yang terhubung dan menawarkan keterampilan orientasi sekali per proyek.
• Biaya: Dengan token, ini membuat satu panggilan whoami. Waktu tunggu jaringan adalah 3 detik, dan waktu tunggu hook adalah 10 detik.
• Sakelar mati: hooks.onboarding.enabled disetel ke false.
• Privasi: Dengan token, hanya permintaan whoami yang terautentikasi yang meninggalkan mesin. Tidak ada prompt, transkrip, atau konten proyek yang keluar melalui hook ini.

Pemanggilan memori

• Kapan dan tindakan: UserPromptSubmit berjalan sebelum setiap prompt yang dikirimkan. Ini melewati perintah, balasan pendek, konfirmasi, dan input khusus kode. Ini menambahkan memori yang relevan ke prompt yang memenuhi syarat.
• Biaya: Dengan token dan prompt yang memenuhi syarat, ini membuat satu panggilan search_memory. Waktu tunggu jaringan adalah 3 detik, dan waktu tunggu hook adalah 8 detik.
• Sakelar mati: hooks.recall.enabled disetel ke false.
• Privasi: Ini mengirim hingga 300 karakter dari prompt yang diciutkan ke Patricia. Ini mengirim teks itu hanya saat token dikonfigurasi.

Integrasi terlebih dahulu

• Kapan dan tindakan: UserPromptSubmit memeriksa prompt. PreToolUse memeriksa input WebFetch, WebSearch, dan Bash sebelum alat berjalan. Katalog lokal mengidentifikasi penyedia yang dikenal.
• Biaya: Ini tidak membuat panggilan MCP atau jaringan dan tidak memerlukan token. Waktu tunggu hook adalah 8 detik untuk prompt dan 5 detik sebelum panggilan alat.
• Sakelar mati: hooks.integrations_first.enabled disetel ke false.
• Privasi: Tidak ada yang meninggalkan mesin. Hook memeriksa prompt atau input alat secara lokal.

Jembatan memori

• Kapan dan tindakan: PostToolUse berjalan setelah Write, Edit, atau MultiEdit. Ini melihat catatan memori lokal yang disimpan dan mengusulkan remember dengan cakupan yang eksplisit.
• Biaya: Ini tidak membuat panggilan MCP atau jaringan. Waktu tunggu hook adalah 5 detik.
• Sakelar mati: hooks.memory_bridge.enabled disetel ke false. File lama ~/.claude/patricia-memory-bridge.json juga dapat menyetel enabled ke false.
• Privasi: Skrip membaca catatan yang disimpan secara lokal dan tidak mengirim apa pun melalui jaringan. Ini mengembalikan jalur catatan dan teks pengingat ke Claude Code, tanpa konten catatan.

Pengingat dorongan

• Kapan dan tindakan: Stop berjalan saat agen selesai. Ini mengusulkan remember setelah penulisan memori lokal atau sesi penggunaan alat yang substansial tanpa penulisan memori ke Patricia.
• Biaya: Ini tidak membuat panggilan MCP atau jaringan. Waktu tunggu hook adalah 8 detik.
• Sakelar mati: hooks.push_reminder.enabled disetel ke false.
• Privasi: Ini membaca paling banyak 5 MB dari transkrip lokal dan tidak mengirim apa pun. Ini hanya berjalan saat token dikonfigurasi, sehingga panggilan memori yang diusulkan dapat berhasil setelah orang tersebut menyetujui.

Jaringan dan kredensial

Plugin ini terhubung ke https://api.patricia.app/v1/mcp melalui Streamable HTTP.

Patricia menggunakan OAuth 2.1 dengan PKCE S256. Alur OAuth yang selesai memberikan token pembawa pribadi pat_mcp_ kepada klien.

Manifest plugin tidak berisi kredensial. Klien mengirim token pembawa ke api.patricia.app setelah masuk.

Marketplace lainnya

• Cursor membaca plugin.json dan mcp.json dari paket ini.
• OpenAI Codex dan ChatGPT membaca .codex-plugin/plugin.json.
• Entri sumber jarak jauh tidak memerlukan manifest. xAI membaca .claude-plugin/plugin.json saat ada.

Semua paket marketplace menunjuk ke satu pohon skills/ di paket ini.

assets/icon.png adalah aset merek Patricia pihak pertama.

Jembatan memori mengusulkan; tidak pernah menulis

Hook adalah perintah shell. Hook tidak memegang klien MCP, tidak memiliki persetujuan dari siapa pun, dan tidak dapat membaca catatan dan membedakan fakta tim dari fakta pribadi. Hook yang mengirim setiap catatan lokal ke ruang kerja bersama akan menempatkan catatan khusus mesin, sementara, dan pribadi di depan seluruh tim, secara diam-diam. Itulah mode kegagalan yang dibangun untuk dihindari oleh jembatan, bukan fitur yang ditunda.

Jadi hook melakukan satu hal: ini menyuntikkan hookSpecificOutput.additionalContext yang memberi tahu agen bahwa catatan itu hanya lokal dan bahwa remember memerlukan scope. Agen memutuskan cakupan, bertanya kepada orangnya, dan membuat panggilan. Penilaian dan penulisan tetap di tempat yang sama.

Empat gerbang menjaganya tetap tenang:

Gerbang	Efek
Salah satu konfigurasi yang didukung menyetel nilai enabled jembatan ke false	Senyap. Tanpa nilai itu, jembatan aktif.
Jalur yang ditulis berada di luar direktori memori	Senyap.
Penulisan tidak berhasil, atau file kosong	Senyap.
Front matter catatan membawa patricia: skip	Senyap.

Ini juga menawarkan catatan tertentu paling banyak sekali per sesi, sehingga Write diikuti oleh serangkaian panggilan Edit menghasilkan satu pengingat, bukan empat. Catatan itu disimpan di ~/.claude/patricia-memory-bridge-state/, satu file per sesi, dipangkas setelah tujuh hari.

Ini tidak menggunakan CLAUDE_PLUGIN_DATA untuk itu. Variabel itu ada di lingkungan hook tetapi tidak dapat diandalkan sebagai direktori plugin yang berjalan: hook tingkat proyek di mesin ini melihatnya disetel ke ~/.claude/plugins/data/codex-openai-codex, direktori data plugin yang tidak terkait.

Alat mana yang sebenarnya digunakan untuk penulisan memori

Claude Code 2.1.238 mendeklarasikan alat bernama memory_list, memory_read, dan memory_write. Di mesin tempat ini dibangun, catatan memori tidak ditulis dengannya: pemindaian 120 transkrip sesi terbaru menemukan 49 panggilan Write dan 35 panggilan Edit ke ~/.claude/projects/*/memory/, dan nol panggilan memory_write.

Karena itu, pencocoknya adalah Write|Edit|MultiEdit. memory_write sengaja ditinggalkan. Menambahkan pencocok untuk alat yang bentuk payloadnya belum diverifikasi menghasilkan hook yang diam-diam tidak pernah aktif dan terlihat persis seperti yang berfungsi. Tambahkan saat payload memory_write yang sebenarnya telah dibaca.

Panduan dan aturan tetap server adalah satu salinan, bukan dua

start_onboarding_import dapat mengembalikan standing_rule_to_offer yang membawa ask_first, instruction, dan blok markdown yang diukur agar muat di CLAUDE.md orang lain. Keterampilan tidak mengulangi blok itu. Ini memberi tahu agen untuk memanggil alat dan menggunakan apa yang kembali, sehingga server tetap menjadi pemilik tunggal dari kata-kata itu.

Mengambilnya saat instalasi adalah alternatifnya, dan itu tidak berhasil. SKILL.md plugin adalah teks statis dalam cache yang dialamatkan berdasarkan konten, tidak ada langkah saat instalasi yang dapat menulis ulang, dan plugin yang tugasnya mencakup menyiapkan Patricia tidak dapat bergantung pada koneksi Patricia terautentikasi yang berfungsi untuk merender instruksinya sendiri. Membaca alat saat digunakan memberikan salinan tunggal yang sama tanpa semua itu.

Setiap nama alat di sini adalah alat yang nyata

Setiap pengidentifikasi alat yang diberi backtick di plugin ini dipegang terhadap registri alat server itu sendiri, daftar yang dibangun server tools/list dari. Pemeriksaan yang sama menegaskan bahwa ia menemukan set pengidentifikasi yang tidak kosong, sehingga ekstraktor yang rusak tidak dapat lolos dengan menemukan apa pun.

Catatan kontributor: pemeriksaan itu adalah backend/api/tests/test_patricia_claude_plugin.py di monorepo Patricia, dan berjalan pada setiap perubahan pada plugin ini.

Pengaturan dan penemuan file

Alat	Penggunaan
get_settings	Daftar pengaturan, atau baca kunci atau grup yang dipilih dengan makna, nilai, dan izin. Kredensial mana pun dapat membaca grup ruang kerja.
update_settings	Ubah satu grup yang diizinkan melalui operasi dasbor. Token pribadi diperlukan.
list_files	Daftar file. Halaman pertama menyertakan folder dan jumlah yang difilter visibilitas.
get_brand_kit	Baca warna merek, tipografi, dan logo.

Gunakan get_settings(keys=["company_profile"]) untuk profil perusahaan. Alat pengaturan berbagi katalog dan operasi yang digunakan Patricia dalam obrolan. Perubahan pengaturan obrolan memerlukan klik dari orang yang meminta. Perubahan kebijakan persetujuan memengaruhi jalur konsol; tindakan kritis dan yang diwajibkan penyedia mempertahankan lantai persetujuannya, dan audiens serta lantai khusus klik mempertahankan lantai mereka pada tindakan apa pun yang sudah ditanyakan Patricia.

Pembacaan integrasi menunggu sementara tugas lain berjalan untuk orang yang sama. Poll tugas itu dengan get_task_status, atau tunggu hingga selesai. Setelah persetujuan integrasi langsung, ikuti kalimat next yang dikembalikan oleh decide_approval. Ini menyebutkan alat yang akan dipanggil lagi dengan tool_ref dan argumen yang sama.