Isifundo se-VibeClaude: Xhuma Imicimbi ye-Claude Code Kumadivayisi e-Intiface

Lokho okwenziwa yi-VibeClaude

I-VibeClaude iyi-plugin ye-Claude Code ehumusha umsebenzi wokubhala ikhodi ube impendulo evela kudivayisi nge-Intiface Central kanye ne-buttplug.io. Imicimbi ye-Claude Code ithunyelwa ku-daemon esebenza endaweni, yona exhumana ne-Intiface Central nge-WebSocket bese ilawula idivayisi ehambisanayo exhunyiwe.

Claude Code — hooks module — HTTP — daemon — WebSocket — Intiface Central — BLE — device

I-plugin iphendula okukhiphayo kwemodeli okusakazwayo, izingcingo zamathuluzi, izicelo zemvume, ama-todo aqediwe, ama-subagent, ukuphazamiseka, kanye nemicimbi yomjikelezo wokuphendula noma weseshini. Yenzelwe indawo yangasese nenethezekile, futhi kufanele usebenzise ihardware ehambisanayo ngokuzibophezela.

Izidingo

• I-Claude Code enokusekelwa kwe-plugin yama-function-hook. I-VibeClaude yakhiwe kusetshenziswa inguqulo 2.1.291 yale API esesigabeni sokufinyelela kusenesikhathi.
• I-Node.js 22 noma entsha etholakala njenge-node ku-PATH yakho.
• I-Intiface Central eneseva yayo ye-WebSocket esebenzayo. Ikheli elizenzakalelayo ngu-ws://127.0.0.1:12345.
• Isilawuli esikwazi ukudlidliza esibhangqwe ku-Intiface Central.
• Indawo yangasese efanele ukusebenzisa idivayisi exhunyiwe.

Faka i-VibeClaude

Clone-a i-repository uye ku-directory yakho yokumisa i-Claude bese ufaka ama-dependency ayo:

git clone https://github.com/transkatgirl/vibeclaude.git ~/.claude/vibeclaude
cd ~/.claude/vibeclaude && npm install

Ungalayisha i-plugin eseshini eyodwa ye-Claude Code usebenzisa:

claude --plugin-dir ~/.claude/vibeclaude

Okunye, yifake unomphela ngaphakathi kwe-Claude Code:

/plugin marketplace add ~/.claude/vibeclaude
/plugin install vibeclaude@vibeclaude-local

Qalisa kabusha i-Claude Code ngemva kokufaka. I-plugin ilayisha lapho kuqala iseshini entsha.

Hlola Indawo Ye-Dependency

I-daemon isebenza ku-directory esetshenziswa yi-Claude Code ukulayisha i-plugin futhi idinga i-directory ye-node_modules lapho. Ama-plugin afakwe nge-marketplace angakopishwa aye endaweni engenawo ama-dependency afakwe ku-clone yakho yokuqala.

Uma i-Claude Code ibonisa umlayezo othi iphakheji ye-npm ethi buttplug ayitholakali, sebenzisa i-npm install ku-directory eshiwo umlayezo.

Xhuma Idivayisi

1. Qalisa i-Intiface Central bese ucindezela inkinobho yokuqalisa iseva.
2. Ku-Claude Code, sebenzisa /intiface.
3. Lindela ukuthi ukuxhumana nokuskena kuqedwe.
4. Khetha idivayisi ekwazi ukudlidliza emiphumeleni.
5. Qala ukusebenzisa i-Claude Code ngemva kokuqinisekisa ukuthi idivayisi ixhunyiwe futhi ifanele indawo okuyo.

Umyalo we-/intiface uvula ibhokisi elibonisa isimo sokuxhumana nokuskena. Sebenzisa okhiye bemicibisholo noma i-Tab ukuhamba kumadivayisi, cindezela u-Enter noma uchofoze ukuze ukhethe eyodwa, bese ucindezela u-Escape ukuphuma ebhokisini.

Akukho okuthunyelwa kudivayisi uze ukhethe eyodwa. I-VibeClaude ilawula idivayisi eyodwa kuphela ekhethiwe ngesikhathi. Lapho kuqala iseshini yakamuva ye-Claude Code, i-plugin izama ukuphinda ixhumane ne-Intiface Central futhi ibuyisele idivayisi ekhethwe ngaphambilini uma itholakala.

Imiyalo Ye-Plugin

• /intiface: Xhuma ku-Intiface, skena amadivayisi, bese ukhetha idivayisi.
• /intiface-connect: Xhuma kuseva ye-Intiface emisiwe bese ubuyisela idivayisi ekhethwe ngaphambilini uma ikhona.
• /intiface-disconnect: Nqamula bese umisa konke okukhipha kudivayisi.
• /intiface-intensity [0.0-1.0]: Setha isiphindaphindi sokuqina somhlaba wonke, noma ubike inani lamanje uma kunganikezwanga inombolo.

Le miyalo isebenza ngaphakathi kwe-plugin ngaphandle kokuqala ukuphenduka kwemodeli noma ukusebenzisa ama-token. Futhi ayishiyi okukhiphayo komyalo engxoxweni futhi ingasetshenziswa ngesikhathi sokuphenduka.

Qonda Amaphethini Empendulo

I-VibeClaude imele umcimbi ngamunye njengephethini enobude besikhathi obumisiwe nokuqina okungaguquki. Engxoxweni eyodwa, umcimbi wakamuva uthatha indawo kowangaphambilini. Isiphindaphindi sokuqina somhlaba wonke sisetshenziswa ngemva kokukhethwa komcimbi.

• Ukucabanga nokubhala okusakazwayo: I-pulse yamamilisekondi angu-70 ngesiqephu ngasinye, enokuqina okusuka ku-0.35 kuye ku-0.8 ngokusekelwe esivinini esimaphakathi sokukhipha. Ukubalwa kwejubane lempendulo kufinyelela umkhawulo kuzinhlamvu ezingu-40 ngomzuzwana.
• Izimpendulo eziphelele: I-pulse yamamilisekondi angu-150 enokuqina okungu-0.4 lapho impendulo ifika ngaphandle kokusakazwa.
• Izingcingo zamathuluzi: I-pulse yamamilisekondi angu-120 enokuqina okungu-0.5 lapho imodeli iqala ukubhala ucingo lwethuluzi.
• Imisebenzi yokuhlela: Ukubamba okuqhubekayo ku-0.3 ngesikhathi kubhalwa futhi kusetshenziswa umsebenzi we-Edit, Write, MultiEdit, noma NotebookEdit.
• Izingcingo zamathuluzi eziphumelele: I-pulse yamamilisekondi angu-180 enokuqina okungu-0.7.
• Izingcingo zamathuluzi ezehlulekile, zenqatshiwe, noma ezaliwa: I-pulse yamamilisekondi angu-280 enokuqina okungu-1.0.
• Izinto ze-todo eziqediwe: I-pulse enokuqina okungu-0.8, ethathelwa indawo ngokushesha yiphethini yempumelelo yethuluzi.
• Izicelo zemvume: Ama-pulse amathathu amamilisekondi angu-90 anokuqina okungu-0.85, alandelwa ikhefu nokuphindaphindwa kuze kuxazululwe isicelo.
• Ukuqedwa kokuphenduka: Ama-pulse amathathu amamilisekondi angu-100 anokuqina okungu-1.0.
• Ukuphenduka okuphazamisekile noma okuhlulekile: Okukhiphayo kwamanje kuyama, kulandelwe ama-pulse amathathu asetshenziselwa ukuqedwa kokuphenduka.
• Ukuphela kweseshini: Konke okukhiphayo kuyama.

Amaseshini Amaningi Nama-Subagent

Iseshini ngayinye evuliwe ye-Claude Code ilandelela amathuluzi ayo, izicelo zayo, ama-todo ayo, kanye nama-subagent ayo. Lapho amaphethini amaningi esebenza, kusetshenziswa enamandla kakhulu. Lapho leyo phethini iphela, idivayisi ingabuyela kuphethini esebenzayo evela kwenye iseshini.

Ama-subagent ahlanganiswa nengxoxo ewaqalile. Okuphumayo okusakazwayo, izingcingo zamathuluzi, izicelo zemvume, ama-todo, kanye nemicimbi yokuqeda noma yokwehluleka zimelelwa ngokuzimela. Ukuvala iseshini eyinhloko kumisa wonke ama-subagent ayo.

Lungisa Ukuqina

Sebenzisa umyalo wokuqina ukuze unciphise noma ukhubaze okuphumayo:

/intiface-intensity 0.5

Isiphindaphindi esizenzakalelayo ngu-1.0. Inani elingu-0 likhubaza impendulo, kanti amanani aphakathi kuka-0 no-1 anciphisa iphethini ngayinye esebenzayo. Ushintsho lusebenza ngokushesha, ngisho nasephethini esivele idlala, futhi luhlala lugciniwe kuze kushintshwe.

Imikhawulo Ebalulekile Yemicimbi

Okunye ukuziphatha kuyisilinganiso ngokwemvelo ngenxa yolwazi u-Claude Code aluveza kuma-plugin:

• Ukucabanga: Ukucabanga kumelwa kuphela lapho u-Claude Code enza umbhalo ubonakale. Isibonelo, ukucabanga akutholakali ngesikhathi sokuqalisa kwe-headless claude -p.
• Izimpendulo zemvume: U-Claude Code akabiki isikhathi esiqondile lapho kuphendulwa khona isicelo semvume. Iphethini yesicelo ivamise ukuphela lapho ithuluzi elihlobene liqeda, lehluleka, noma lenqatshwa. Ezinye izinkomba zokusebenzisa i-terminal ngemuva zingayimisa ngaphambi kwalokho.
• Okuphumayo kwethuluzi: I-plugin ayikutholi okuphumayo komyalo njengoba kusakazwa, ngakho okuphumayo kwethulwa ngomphumela wethuluzi esikhundleni somugqa ngamunye ophrintiwe.

Lungisa I-plugin

U-Claude Code ubuza ngezinketho ze-plugin uma uyivula. Ungazishintsha kamuva nge-/plugin nangesixhumi esibonakalayo sokuphatha ama-plugin.

• wsAddress: Ikheli le-Intiface Central WebSocket. Okuzenzakalelayo yi-ws://127.0.0.1:12345.

Ikheli le-WebSocket elishintshiwe lisebenza ngesikhathi esilandelayo sokuqala kwe-daemon. Qeda amasession akho, noma misa i-daemon ngokuqondile ngalo myalo:

node daemon/daemon.mjs stop

IVibeClaude igcina idivayisi ekhethiwe, ukuqina, kanye ne-daemon.log ngaphansi kwe-~/.config/vibeclaude. Uma imbobo ye-TCP 12350 isetshenziswa kakade, dala ~/.config/vibeclaude/config.json enembobo ehlukile:

{ "port": 12351 }

Sebenzisa I-daemon Kusuka Ku-Shell

I-daemon ingalawulwa ngokuzimela emiyalweni ye-Claude Code ye-slash. Le miyalo isebenzisa ifolda yokumisa nekheli le-WebSocket okuzenzakalelayo:

• node daemon/daemon.mjs scan: Xhuma, skena imizuzwana emithathu, bese ubhala uhlu lwamadivayisi akwazi ukudlidliza.
• node daemon/daemon.mjs select <index>: Khetha idivayisi emiphumeleni yokuskena.
• node daemon/daemon.mjs connect kanye ne-disconnect: Xhuma noma unqamule ku-Intiface.
• node daemon/daemon.mjs intensity [value]: Setha noma ubonise isiphindaphindi sokuqina.
• node daemon/daemon.mjs start: Qinisekisa ukuthi i-daemon iyasebenza bese uphrinta imbobo yayo.
• node daemon/daemon.mjs status: Hlola ukuthi i-daemon iyaphendula yini.
• node daemon/daemon.mjs stop: Misa konke okuphumayo bese uphuma ku-daemon.
• node daemon/daemon.mjs: Qalisa i-daemon ngaphambili.

Sebenzisa i---home <dir> ukukhetha elinye ifolda yokumisa kanye ne---ws <address> ukucacisa elinye ikheli le-Intiface. Ukuze urekhode yonke imicimbi njengoba ifika, setha i-variable yemvelo yokulungisa amaphutha:

VIBECLAUDE_DEBUG=1 node daemon/daemon.mjs

Hlola Ngaphandle Kwe-Hardware

Indawo yokugcina ikhodi ihlanganisa iseva ye-Intiface eyisifaniso ephrinta izinga lemoto ebizolithola. Iqalise embobeni engu-12345:

node test/mock-intiface.mjs 12345

Bese uqalisa iqoqo lokuhlola:

npm test

Ukuhlola kusebenzisa i-daemon kusukela ekuqaleni kuze kube sekupheleni ngokumelene nesifaniso sayo futhi kuhlola imojuli yama-hook, okukuvumela ukuthi uhlole ukufakwa ngaphandle kwesilawuli esiphathekayo.

Indlela Isakhiwo Esisebenza Ngayo

hooks/register.tsx isebenza ngaphakathi kwe-Claude Code. Ibheka imicimbi yama-hook efana nezinyathelo zoshintsho ezisakazwayo, izingcingo zamathuluzi, ukuhlolwa kwezimvume, ukudalwa kwama-subagent, kanye nezinguquko zomjikelezo weshini noma woshintsho. Yehlisa leyo micimbi ibe imilayezo emincane equkethe osayizi nezihlonzi esikhundleni sombhalo wemodeli, bese iyithumela ngokulandelana ku-daemon ekhelini le-loopback 127.0.0.1:12350.

Imojuli yama-hook iphinde ibhalise imiyalo ye-slash, ibonise ibhokisi lokukhetha idivayisi, futhi ibonise izaziso ze-daemon njengama-toast. Ngenxa yokuthi imojuli yama-hook ayikwazi ukufinyelela ku-Node.js, ayikwazi ukusebenzisa iklayenti le-Buttplug noma igcine uxhumano lwe-Intiface WebSocket ngokwayo.

daemon/daemon.mjs iphatha iklayenti elisemthethweni le-Buttplug, uxhumano lwe-Intiface, idivayisi ekhethiwe, injini yokudlidliza, nabaphathi bemicimbi. Njengoba idivayisi ingaphendula kancane kunokufika kokuphumayo kwemodeli, i-daemon ithumela izinga lokugcina eliceliwe esikhundleni sokwakha ulayini ongemuva.

I-daemon iqala lapho iseshini yokuqala iyidinga futhi iyaphuma ngemva kokuphela kweseshini yokugcina. Iqapha inqubo ye-Claude Code ehlotshaniswa neseshini ngayinye futhi ingahlanza amasession anyamalala ngokungalindelekile. Uma ingakwazi ukunquma ukuthi iyiphi inqubo ephelile, igcina ngokuphuma ngemva kwemizuzu engu-30 ngaphandle komsebenzi.

Ubumfihlo Nokuvala Okuzenzakalelayo

I-plugin ithumela imiyalo yedivayisi kuphela ekhelini le-Intiface elilungiselelwe emshinini wakho. I-daemon ilalela ku-loopback futhi yamukela izicelo ze-JSON eziqondiswe ku-127.0.0.1 noma ku-localhost; ayivezi isevisi yenethiwekhi yamakhasi esiphequluli. IVibeClaude ayinayo i-telemetry.

Okuphumayo kuyama ngokuzenzakalelayo lapho ushintsha amadivayisi, uqeda iseshini, unqamula, ulahlekelwa uxhumano lwe-Intiface, noma i-daemon iphuma. Uma idivayisi inqamuka ku-Intiface, ayisakhethwa; sebenzisa i-/intiface ukuze uphinde uxhume. Idivayisi enyamalala okwesikhashana ingakhethwa futhi lapho ibuya.

Isiphetho

IVibeClaude ixhuma amahuku e-Claude Code ne-Intiface Central nge-daemon yendawo ye-Node.js, iguqule imicimbi yokubhala ikhodi ibe yimpendulo yedivayisi elungisekayo. Faka i-plugin nezincike kuyo, qala i-Intiface Central, khetha idivayisi nge-/intiface, bese ulungisa umuzwa nge-/intiface-intensity. Ukuze uxazulule izinkinga futhi uthuthukise, sebenzisa imiyalo ye-shell daemon, ukuloga kokulungisa amaphutha, kanye neseva ye-mock efakiwe.

Le phrojekthi inelayisensi ngaphansi kwe-MIT License. I-Buttplug ne-Intiface yizimpawu zokuhweba ze-Nonpolynomial Labs, LLC.