Mafunzo ya Harp: Panga Mawakala wa Claude Code na Codex katika Upau wa Pembeni Tulivu wa macOS

Harp ni fork isiyo rasmi ya macOS ya terminali ya Warp yenye chanzo huria. Inahifadhi uwezo wa terminali, AI, na wingu wa Warp huku ikibadilisha upau wa kawaida wa vichupo na upau wa pembeni ulioundwa kwa ajili ya mawakala wa usimbaji wanaofanya kazi kwa muda mrefu.

Ukitumia Harp, unaweza kuendesha vipindi vingi vya Claude Code na Codex kando kwa kando na kuona kwa haraka ni vipindi vipi vinavyofanya kazi, vinakusubiri, vimekamilika, vinaendelea chinichini, au vimewekwa kando. Harp haiendeshi seva zake; vipengele vya Warp vya juu bado huwasiliana na seva za Warp kama ilivyo katika Warp.

Harp inaongeza nini

Hali ya wakala kwa muhtasari

Kila safu ya upau wa pembeni inaweza kuonyesha hali ya kipindi cha Claude Code au Codex. Alama ya kutosomwa hubaki hadi ukikague kipindi, nukta inaonyesha kuwa kazi ya chinichini bado inaendelea, na mwezi hutambulisha kichupo ulichoweka kando. Tumia Cmd+R kubadilisha jina la kichupo.

Vikundi vinavyoendelea

Unaweza kuweka vichupo katika vikundi vyenye majina ili kupanga miradi na mawakala. Muunganisho wa tmux ukiwezeshwa, Harp huhifadhi kikundi na mpangilio katika vipindi vya tmux. Hii huruhusu mpangilio kuendelea baada ya kuwasha upya na kuwawezesha wateja wengine wa tmux kuona mpangilio huo huo.

Duara za kikomo cha matumizi

Mguu wa upau wa pembeni unaweza kuonyesha duara mbili kwa kila mtoa huduma: moja kwa kipindi cha saa tano na nyingine kwa kikomo cha kila wiki. Harp husoma thamani hizi kutoka kwenye faili ya ndani ya JSON inayodumishwa na zana unayoichagua. Haipakui data ya matumizi yenyewe. Tazama nyaraka za muundo wa duara za kikomo kwa muundo unaotarajiwa wa faili.

Vipindi vya tmux vinavyofaa simu

Vipindi vilivyounganishwa na tmux vinaweza kubeba jina, kikundi, hali ya kusomwa, na alama ya kutotumika. Kipindi cha tmux kilichoanzishwa kwingine, kama vile kutoka kwenye simu kupitia SSH, kinaweza kuomba kichupo cha Harp kwa kuweka chaguo la tmux @warp_adopt kuwa 1.

Sakinisha Harp

Sakinisha toleo jipya zaidi la macOS

1. Fungua toleo jipya zaidi la Harp kutoka ukurasa wa GitHub Releases.
2. Pakua faili ya Harp-<version>.dmg.
3. Fungua picha ya diski na uburute Harp hadi kwenye folda ya Applications.

Harp hutumia kitambulisho chake cha kifurushi, com.dominikmartn.Harp, mpango wa URL, harp://, na saraka ya mipangilio, ~/.harp. Hii huiruhusu kufanya kazi pamoja na Warp bila kushiriki rasilimali hizo.

Jenga kutoka kwenye chanzo

Ili kujijengea Harp, tumia macOS na zana za Rust zilizoainishwa katika rust-toolchain.toml. Kutoka kwenye mzizi wa hazina, endesha hati ya bootstrap mara moja:

./script/bootstrap

Kisha kusanya na uzindue programu ya utatuzi:

./script/run

Jengo hutengeneza target/debug/bundle/osx/Harp.app na kuizindua. Hati ya uendeshaji ya macOS husaini programu kwa kutumia utambulisho wa kwanza wa Apple Development katika keychain yako, au hutumia saini ya muda inaposhindikana. Kwa DMG ya toleo iliyosainiwa na inayoweza kuwasilishwa kwa notarization, tumia script/release_macos na usome matokeo ya msaada wake.

Sanidi Harp

Miunganisho ya ziada ya Harp imezimwa kwa chaguo-msingi. Unda au hariri ~/.harp/settings.toml, kisha wezesha vipengele unavyohitaji. Harp hupakia upya faili ya mipangilio inapobadilika.

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

[integrations.tmux]
enabled = true

Wezesha duara za kikomo cha matumizi

Weka integrations.limit_rings.enabled kuwa true na uelekeze integrations.limit_rings.file kwenye faili ya ndani ya JSON iliyo na thamani za matumizi ya mtoa huduma wako. Herufi ~ inawakilisha saraka yako ya nyumbani.

Wezesha ulandanishi wa tmux

Weka integrations.tmux.enabled kuwa true ili kuwezesha ulandanishi wa tmux, upokeaji wa vipindi, na utambuzi wa mawakala ndani ya tmux. Harp hukagua tmux kila baada ya sekunde 10.

tmux ikiwa imewezeshwa, majina, vikundi, mpangilio, alama za kusomwa, alama za kutotumika, na vipindi vilivyopokelewa vinaweza kulandanishwa. Ikiwa unahitaji tabia maalum, integrations.tmux.session_script inaweza kuelekezwa kwenye hati inayoshughulikia kubadilisha majina na kupanga upya vikundi. Hati hupokea amri katika miundo hii:

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

Rekebisha upau wa pembeni na upau wa zana wa mawakala

• appearance.vertical_tabs.full_tab_menu ina thamani ya true kwa chaguo-msingi. Weka false ili kupunguza menyu za vichupo na vikundi ziwe na vitendo muhimu pekee. Chaguo hilo hilo linapatikana kwenye Settings > Appearance > Tabs.
• agents.third_party.should_render_cli_agent_toolbar ina thamani ya false kwa chaguo-msingi. Weka true ili kurejesha upau wa zana wa juu chini ya vipindi vya mawakala wa CLI.

Upau wa zana wa wakala wa CLI wa wahusika wengine ukiwa umezimwa, sasisha programu-jalizi ya Warp ya Claude Code kupitia soko la programu-jalizi la Claude Code, kama ilivyoelezwa na mradi.

Tumia Harp pamoja na mawakala wa usimbaji

1. Fungua Harp na uunde vipindi kwa ajili ya mitiririko yako ya Claude Code au Codex.
2. Badilisha majina ya vichupo kwa kutumia Cmd+R ili madhumuni yake yawe wazi.
3. Weka vipindi vinavyohusiana katika vikundi vyenye majina, kama vile kikundi kwa kila mradi.
4. Fuatilia viashiria vya hali kwenye upau wa pembeni ili kutambua vipindi vinavyohitaji uangalizi wako, ambavyo bado vinafanya kazi, au ambavyo vimekamilika.
5. Weka kando vipindi usivyovihitaji mara moja; Harp huvitia alama ya mwezi.
6. Fungua vipindi visivyosomwa ukiwa tayari kukagua matokeo yake.

Vichupo vipya vinaweza kuundwa kwa kutumia Cmd+T, kwa kubofya mara mbili, au kupitia menyu ya kubofya kulia kwenye nafasi tupu ya upau wa pembeni. Mradi huondoa kimakusudi baadhi ya vidhibiti vya upau wa vichupo, ikiwemo sehemu ya kutafuta, chaguo za mwonekano, na vitufe vya kusanidi vichupo.

Pokea kipindi kilichoanzishwa mahali pengine

Kipindi cha tmux kinapoundwa kutoka kwenye kifaa au terminal nyingine, unaweza kuomba Harp ikipokee kama kichupo. Katika kipindi husika cha tmux, endesha:

tmux set-option @warp_adopt 1

Baada ya ujumuishaji wa tmux kuwashwa, Harp inaweza kufuatilia kipindi hicho na kuonyesha jina, kikundi, na hali yake kwenye upau wa pembeni. Hii ni muhimu kwa kuendelea na kazi iliyoanzishwa kupitia SSH, ikiwemo kutoka kwenye simu.

Unganisha utoaji wa ripoti za kazi za nyuma wa Claude Code

Hifadhi hii inajumuisha hook ya Claude Code inayoripoti kazi za nyuma kwa Harp. Maelekezo ya ujumuishaji yanapatikana katika integrations/claude-code. Tumia maelekezo hayo unapotaka shughuli za nyuma zionekane kwenye upau wa pembeni.

Chaguo za kina za uundaji

Fuatilia mabadiliko ya hali

Kwa ukaguzi wa kurudi nyuma dhidi ya nakala ya mazungumzo ya wakala, zindua muundo wa utatuzi ukiwa na WARPOSS_STATUS_TRACE=1. Harp huandika mabadiliko ya hali kwenye ~/Library/Logs/harp.log kama mistari ya [status-check].

Endesha bila kuingia halisi

Weka WARPOSS_SKIP_LOGIN=1 wakati wa kuzindua ili kuanza na mtumiaji wa majaribio na kufanya maombi yaliyothibitishwa yashindwe. Hii imekusudiwa kwa uendeshaji wa kiotomatiki usiotumia kuingia.

Tumia wasifu wa data uliotengwa wa utatuzi

Kwa miundo ya utatuzi, weka WARP_DATA_PROFILE=<name> ili kuhifadhi mipangilio na data katika ~/.harp-<name> badala ya eneo chaguo-msingi la wasifu.

Thibitisha michango

Kabla ya kuwasilisha mabadiliko, endesha ukaguzi wa presubmit wa hifadhi:

./script/presubmit

Hii huendesha uumbizaji, Clippy, na majaribio.

Hitimisho

Harp hubadilisha terminali ya Warp kuwa nafasi ya kazi ya kudhibiti vipindi vingi vya Claude Code na Codex vinavyoendelea kwa muda mrefu. Sakinisha programu ya macOS au iunde kutoka kwenye msimbo wa chanzo, washa ujumuishaji wa tmux na limit-ring inapohitajika, kisha tumia vikundi na viashiria vya hali ili kuweka maendeleo yanayoendeshwa na mawakala katika mpangilio. Harp ni fork isiyo rasmi ya Warp, kwa hivyo ripoti masuala mahususi ya Harp kwenye hifadhi yake badala ya Warp.