Isifundo se-Harp: Hlela ama-ejenti e-Claude Code ne-Codex kubha eseceleni ezolile ye-macOS

I-Harp iyifork ye-macOS engekho emthethweni ye-Warp terminal yomthombo ovulekile. Igcina amakhono e-terminal, e-AI, nawefu e-Warp, kodwa ishintsha ibha yamathebhu evamile ibe ibha eseceleni eyakhelwe ama-agent okubhala ikhodi asebenza isikhathi eside.

Nge-Harp, ungasebenzisa izikhathi eziningi ze-Claude Code ne-Codex zibheke eceleni futhi ubone ngokushesha ukuthi yiziphi izikhathi ezisebenzayo, ezikulindile, eziqediwe, ezisebenza ngemuva, noma ozibeke eceleni. I-Harp ayisebenzisi amaseva ayo; izici ze-Warp ezivela kumthombo wokuqala ziyaqhubeka nokuxhumana namaseva e-Warp ngendlela efanayo nase-Warp.

Okungezwa yi-Harp

Isimo se-agent ngokubuka nje

Umugqa ngamunye webha eseceleni ungabonisa isimo sesikhathi se-Claude Code noma se-Codex. Umaka ongafundiwe uhlala ubonakala kuze kube uhlola isikhathi, ichashazi libonisa ukuthi umsebenzi wangemuva usasebenza, kanti inyanga ikhomba ithebhu oyibeke eceleni. Sebenzisa Cmd+R ukuqamba kabusha ithebhu.

Amaqembu ahlala ekhona

Ungafaka amathebhu emaqenjini aqanjwe amagama ukuze ugcine amaphrojekthi nama-agent ehlelekile. Uma ukuhlanganiswa kwe-tmux kunikwe amandla, i-Harp igcina iqembu nokuhleleka kumaseshini e-tmux. Lokhu kwenza ukwakheka kuqhubeke ngemva kokuqalisa kabusha futhi kuvumela amanye amaklayenti e-tmux ukuthi abone ukuhlelwa okufanayo.

Izindandatho zemikhawulo yokusetshenziswa

Unyawo lwebha eseceleni lungabonisa izindandatho ezimbili kumhlinzeki ngamunye: eyodwa yewindi lamahora amahlanu nenye yomkhawulo wamasonto onke. I-Harp ifunda la magugu efayelini lendawo le-JSON eligcinwa ithuluzi olikhethayo. Ayilandi idatha yokusetshenziswa ngokwayo. Bheka imibhalo yefomethi yezindandatho zemikhawulo ukuze ubone ifomethi yefayela elindelekile.

Amaseshini e-tmux alungele ifoni

Amaseshini axhunywe ku-tmux angaphatha igama lawo, iqembu, isimo sokufunda, kanye nefulegi lokungasebenzi. Iseshini ye-tmux eqaliswe kwenye indawo, njengasefonini nge-SSH, ingacela ithebhu ye-Harp ngokusetha inketho ye-tmux @warp_adopt ibe 1.

Faka i-Harp

Faka inguqulo yakamuva ye-macOS

1. Vula ukukhishwa kwakamuva kwe-Harp ekhasini le-GitHub Releases.
2. Landa ifayela elithi Harp-<version>.dmg.
3. Vula isithombe sediski bese uhudulela i-Harp kufolda ye-Applications.

I-Harp isebenzisa isihlonzi sayo se-bundle, com.dominikmartn.Harp, uhlelo lwe-URL, harp://, kanye nefolda yezilungiselelo, ~/.harp. Lokhu kuyivumela ukuthi isebenze eceleni kwe-Warp ngaphandle kokwabelana ngalezo zinsiza.

Yakha kusukela kumthombo

Ukuze uzakhele i-Harp, sebenzisa i-macOS kanye namathuluzi e-Rust acaciswe ku-rust-toolchain.toml. Usuka empandeni yenqolobane, sebenzisa iskripthi sokuqala kanye:

./script/bootstrap

Bese uhlanganisa futhi uqalise uhlelo lokulungisa amaphutha:

./script/run

Ukwakhiwa kukhiqiza target/debug/bundle/osx/Harp.app bese kuyaliqalisa. Iskripthi sokuqalisa se-macOS sisayina uhlelo sisebenzisa isihlonzi sokuqala se-Apple Development ku-keychain yakho, noma sisebenzise isiginesha ye-ad-hoc uma singasitholi. Ukuze uthole i-DMG ekhishiwe esayiniwe futhi engathunyelwa ku-notarization, sebenzisa script/release_macos bese ubheka usizo lwayo.

Lungiselela i-Harp

Ukuhlanganiswa okwengeziwe kwe-Harp kuvaliwe ngokuzenzakalelayo. Dala noma hlela ~/.harp/settings.toml, bese unika amandla izici ozidingayo. I-Harp ilayisha kabusha ifayela lezilungiselelo lapho lishintsha.

[integrations.limit_rings]
enabled = true
file = "~/.cache/limit-rings.json"

[integrations.tmux]
enabled = true

Nika amandla izindandatho zemikhawulo yokusetshenziswa

Setha integrations.limit_rings.enabled ibe true bese ukhomba integrations.limit_rings.file efayelini lendawo le-JSON eliqukethe amagugu okusetshenziswa kwabahlinzeki bakho. Uhlamvu ~ lumelela ifolda yakho yasekhaya.

Nika amandla ukuvumelanisa kwe-tmux

Setha integrations.tmux.enabled ibe true ukuze unike amandla ukuvumelanisa kwe-tmux, ukwamukelwa kwamaseshini, nokutholwa kwama-agent ngaphakathi kwe-tmux. I-Harp ihlola i-tmux njalo ngemizuzwana engu-10.

Uma i-tmux inikwe amandla, amagama, amaqembu, ukuhleleka, amafulegi okufunda, amafulegi okungasebenzi, namaseshini amukelwe kungavumelaniswa. Uma udinga ukuziphatha okwenziwe ngokwezifiso, integrations.tmux.session_script ingakhomba iskripthi esiphatha ukuqamba kabusha nokuhlela kabusha amaqembu. Iskripthi samukela imiyalo ngalezi zindlela:

<script> rename <shell_pid> <group> <title>
<script> group <session_id> <old_group> <new_group>

Lungisa ibha eseceleni nebha yamathuluzi yama-agent

• appearance.vertical_tabs.full_tab_menu iba ku-true ngokuzenzakalelayo. Yisete ibe false ukuze unciphise amamenyu amathebhu namaqembu abe yizenzo ezibalulekile. Le nketho iyatholakala futhi ngaphansi kokuthi Settings > Appearance > Tabs.
• agents.third_party.should_render_cli_agent_toolbar iba ku-false ngokuzenzakalelayo. Yisete ibe true ukuze ubuyisele ibha yamathuluzi evela kumthombo wokuqala ngaphansi kwamaseshini ama-agent e-CLI.

Uma ibha yamathuluzi ye-CLI agent yenkampani yangaphandle ivaliwe, buyekeza i-plugin ye-Warp ye-Claude Code usebenzisa imakethe yama-plugin ye-Claude Code, njengoba kuchazwe iphrojekthi.

Sebenzisa i-Harp nama-agent okubhala ikhodi

1. Vula i-Harp bese udala amaseshini okuhamba komsebenzi wakho kwe-Claude Code noma kwe-Codex.
2. Qamba kabusha amathebhu nge-Cmd+R ukuze injongo yawo icace.
3. Faka amaseshini ahlobene emaqenjini aqanjwe amagama, njengeqembu lephrojekthi ngayinye.
4. Bheka izinkomba zesimo kubha eseceleni ukuze ubone amaseshini adinga ukunakwa kwakho, asasebenza, noma aqediwe.
5. Beka eceleni amaseshini ongawadingi ngokushesha; i-Harp iwaphawula ngenyanga.
6. Vula amaseshini angafundiwe uma usulungele ukubuyekeza umphumela wawo.

Amathebhu amasha angadalwa nge-Cmd+T, ngokuchofoza kabili, noma ngemenyu yokuchofoza kwesokudla endaweni engenalutho kubha eseceleni. Iphrojekthi isusa ngamabomu ezinye izilawuli zebha yamathebhu, okuhlanganisa inkambu yokusesha, izinketho zokubuka, nezinkinobho zokumisa amathebhu.

Yamukela iseshini eqalwe kwenye indawo

Uma iseshini ye-tmux idalwe kwenye idivayisi noma itheminali, ungacela u-Harp ukuthi ayamukele njengethebhu. Kuseshini ye-tmux efanele, sebenzisa:

tmux set-option @warp_adopt 1

Ngemva kokunika amandla ukuhlanganiswa kwe-tmux, u-Harp angalandela leyo seshini futhi abonise igama layo, iqembu layo, nesimo sayo kubha eseceleni. Lokhu kuwusizo ekuqhubekeni nomsebenzi oqalwe nge-SSH, kuhlanganise nowasefoni.

Xhuma ukubikwa kwemisebenzi yangemuva ye-Claude Code

Indawo yokugcina ikhodi ihlanganisa i-hook ye-Claude Code ebika imisebenzi yangemuva ku-Harp. Imiyalelo yokuhlanganisa iyatholakala ku-integrations/claude-code. Sebenzisa le miyalelo uma ufuna umsebenzi wangemuva uvele kubha eseceleni.

Izinketho ezithuthukile zokuthuthukisa

Landelela izinguquko zesimo

Ukuze uhlole ukuhlehla ngokumelene nombhalo wengxoxo we-ejenti, qalisa i-debug build nge-WARPOSS_STATUS_TRACE=1. U-Harp ubhala izinguquko zesimo ku-~/Library/Logs/harp.log njengemigqa ene-[status-check].

Qalisa ngaphandle kokungena kwangempela

Setha i-WARPOSS_SKIP_LOGIN=1 ngesikhathi sokuqalisa ukuze uqale ngomsebenzisi wokuhlola futhi wenze izicelo eziqinisekisiwe zehluleke. Lokhu kuhloselwe ukuqalisa okuzenzakalelayo okungasebenzisi ukungena.

Sebenzisa iphrofayela yedatha ye-debug ehlukanisiwe

Kuma-debug build, setha i-WARP_DATA_PROFILE=<name> ukuze ugcine izilungiselelo nedatha ku-~/.harp-<name> esikhundleni sendawo yephrofayela ezenzakalelayo.

Qinisekisa iminikelo

Ngaphambi kokuthumela izinguquko, sebenzisa ukuhlolwa kwe-presubmit kwendawo yokugcina ikhodi:

./script/presubmit

Lokhu kusebenzisa ukufometha, i-Clippy, kanye nezivivinyo.

Isiphetho

U-Harp uguqula itheminali ye-Warp ibe yindawo yokusebenza yokuphatha amasession amaningi e-Claude Code ne-Codex aqhubeka isikhathi eside. Faka uhlelo lokusebenza lwe-macOS noma ulwakhe kusukela kukhodi yomthombo, unike amandla ukuhlanganiswa kwe-tmux ne-limit-ring lapho kudingeka, bese usebenzisa amaqembu nezinkomba zesimo ukuze ugcine ukuthuthukiswa okuqhutshwa ama-ejenti kuhlelekile. U-Harp uyifoloki ye-Warp engekho emthethweni, ngakho bika izinkinga eziqondene no-Harp endaweni yayo yokugcina ikhodi, hhayi kwa-Warp.