npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@bybrawe/opencode-goal

v1.3.47

Published

Native OpenCode 2 goals with host-verified completion, crash-safe per-unit sessions, a read-only sidebar, and explicit OpenCode 1 compatibility.

Readme

OpenCode Goals

Dil: English · Türkçe

npm version npm downloads license

OpenCode için kalıcı, host tarafından doğrulanan Goal modu.

OpenCode Goals, uzun süren yapay zeka kodlama görevleri için bir OpenCode goal eklentisidir. Kalıcı bir /goal iş akışı ekleyerek OpenCode kodlama ajanının tek bir açık hedefi birden fazla tur, context compaction, kesintiler, delege edilen işler ve süreç yeniden başlatmaları boyunca korumasını sağlar. Tamamlanma ise executor modelinin yalnızca “bitti” demesine değil, güncel host kanıtlarına bağlıdır.

Bir OpenCode autonomous agent, persistent goal mode, multi-turn coding agent, OpenCode için Codex tarzı uzun süreli goal workflow veya bağımsız completion verification sunan bir OpenCode eklentisi arıyorsanız bu paket bu kullanım için tasarlanmıştır.

Bağımsız OpenCode eklentisidir. “Codex tarzı” ifadesi yalnızca uzun süreli goal workflow modelini anlatır; herhangi bir onay, bağlantı veya özellik eşitliği iddiası değildir.

Kurulum veya güncelleme

Önerilen tek komutlu kurulum:

npx -y @bybrawe/opencode-goal@latest

Güncellemek istediğinizde aynı komutu yeniden çalıştırın.

Alternatif olarak installer'ı global kurabilirsiniz:

npm install -g @bybrawe/opencode-goal@latest
opencode-goal

Ardından OpenCode'u tamamen kapatıp yeniden açın ve doğrulayın:

/goal status

OpenCode slash-command listesinde /goal komutunu da görmelisiniz.

Yalnızca npm install @bybrawe/opencode-goal çalıştırmak paketi mevcut Node projesine kurar. Eklentiyi OpenCode'a kaydetmez. Yukarıdaki npx installer'ını veya global installer komutunu kullanın.

Installer ne yapar?

Installer:

  • global OpenCode config dizinini bulur;
  • config yoksa oluşturur;
  • OpenCode plugin listesine @bybrawe/opencode-goal@<exact-version> ekler ve exact sürüme sabitler;
  • eski, sürümsüz veya @latest Goal plugin kayıtlarını yükseltir;
  • bilinen yinelenen eski yerel Goal plugin kopyalarını kaldırır;
  • OpenCode 1.x üzerinde /goal komutunun keşfedilebilir olması için yönetilen global commands/goal.md köprüsünü kurar;
  • OpenCode 2.x üzerinde native plugins config alanını yazar ve eski command bridge yerine plugin-native /goal komutunu kullanır;
  • Goal'a ait kayıt dışındaki ilgisiz OpenCode ayarlarını, plugin kayıtlarını ve JSONC yorumlarını korur.

Varsayılan OpenCode konumları:

macOS / Linux:

~/.config/opencode/opencode.json or opencode.jsonc
~/.config/opencode/commands/goal.md   # yalnız OpenCode 1.x bridge

Windows:

%USERPROFILE%\.config\opencode\opencode.json or opencode.jsonc
%USERPROFILE%\.config\opencode\commands\goal.md   # yalnız OpenCode 1.x bridge

OpenCode 2 paket kökünü resmi Plugin.define({ id, setup }) giriş noktası olarak yükler; aynı dual tanım host uyumluluğu için ./server altında da sunulur. Programatik named API'ler V2 kökünü V1 runtime importlarından temiz tutmak için @bybrawe/opencode-goal/api alt yolundadır; açık legacy V1 plugin fonksiyonu ise ./v1 altında izole edilir.

OpenCode 2, V2 lifecycle ve autonomous coordinator yolunu varsayılan olarak etkinleştirir. Native plugins kayıtları üzerinden { "package": "@bybrawe/opencode-goal@<version>", "options": { "lifecycle": false, "autonomous": false } } ile iki katman ayrı ayrı kapatılabilir. Eski OPENCODE_GOAL_V2_DIRECT_LIFECYCLE ve OPENCODE_GOAL_V2_AUTONOMOUS ortam değişkenleri daha yüksek öncelikli acil kapatma anahtarı olarak korunur: ilgili V2 katmanını kapatmak için 0, false, no veya off verilebilir. Tanınmayan açık environment değerleri fail-closed davranır. Uygun hostlarda V2-native prompt admission ve tool-execution hook'ları doğrudan kullanılır; uzun süren evidence/completion araçları host-native tool progress API'si üzerinden ilerleme bildirir.

Neden OpenCode Goals?

Normal coding-agent konuşmaları çok sayıda tur, compaction, retry veya kesinti sonrasında ilk sonucu/hedefi kaybedebilir. OpenCode Goals başarı sınırını açık ve kalıcı tutar.

Temel özellikler:

  • Turlar arasında kalıcı Goal — hedef autonomous continuation boyunca aktif kalır.
  • Uzun süreli agent workflow — OpenCode idle sınırlarından sonra Goal'a ait çalışmayı sürdürebilir.
  • Host-verified completion — shell kontrolleri, file contracts, mutation evidence ve güncel workspace durumu plugin tarafından doğrulanabilir.
  • Bağımsız semantic verifier — executor yalnızca işin bittiğini söylediği için kendisini başarılı ilan edemez.
  • False-completion koruması — eksik, eski, dolaylı veya uydurulmuş kanıt fail-closed davranışıyla reddedilir.
  • Multi-turn cadence koruması — “10 ayrı turda her seferinde tam +1 yap” gibi hedefler yalnızca final dosya değerine bakılarak kanıtlanmaz.
  • Restart recovery — proje içindeki state, OpenCode/süreç yeniden başlatmalarından sonra korunur.
  • Compaction persistence — Goal context korunurken model context penceresini OpenCode yönetmeye devam eder. Aktif otomatik/manuel compaction ownership ve paused-resume ayrımı için compaction & continuation sözleşmesine bakın.
  • Budget'lar — turn, token, runtime ve isteğe bağlı cost limitleri autonomous çalışmayı sınırlar.
  • Goal queue — tek bir canlı Goal korunurken gelecekteki Goal'lar inert sıralı queue içinde hazırlanabilir.
  • Windows / macOS / Linux paketleme — installer ve package smoke coverage çapraz platformdur.

Hızlı başlangıç

Gerçek bir doğrulama komutuyla Goal başlatın:

/goal fix the failing tests --check "npm test"

Daha kapsamlı bir Goal Contract oluşturun:

/goal refactor auth \
  --success "all auth tests pass" \
  --success "existing callers remain compatible" \
  --constraint "do not add a runtime dependency" \
  --non-goal "do not redesign unrelated session code" \
  --check "npm test"

Canlı contract ve proof durumunu inceleyin:

/goal status
/goal contract
/goal audit

Duraklatın ve devam ettirin:

/goal pause
/goal resume

Goal paused durumundayken devam et, continue veya resume gibi kısa ve açık bir devam mesajı da aynı lifecycle control zinciri üzerinden Goal'ı yeniden aktive eder. Diğer normal chat mesajları paused Goal'ı sessizce yeniden başlatmaz.

Gelecekteki Goal'ları sıraya ekleyin:

/goal add update docs --success "docs match shipped behavior"
/goal add prepare release notes --check "npm test"
/goal queue

Yaygın kullanım alanları

OpenCode Goals, bir AI coding agent'ın gerçek bir sonuç elde edilene kadar hedefi koruması gerektiğinde kullanışlıdır. Örneğin:

  • başarısız bir test suite'ini birçok iterasyonda düzeltmek;
  • refactor veya migration işini birden fazla model turunda sürdürmek;
  • “N ayrı tur/cycle” gibi zamansal çalışma gereksinimlerini zorunlu tutmak;
  • hedefi context compaction boyunca korumak;
  • OpenCode kapatılıp yeniden açıldıktan sonra yarım kalan işi geri yüklemek;
  • autonomous coding sırasında erken “bitti” iddialarını engellemek;
  • completion öncesi file evidence, shell checks veya semantic verification istemek;
  • aynı projede ayrı OpenCode session'larında bağımsız Goal'lar çalıştırırken Goal state'lerini izole tutmak.

Temel komutlar

| Komut | Amaç | |---|---| | /goal <objective> | Bitmemiş canlı Goal yokken yeni Goal başlatır | | /goal status | Mevcut Goal durumunu gösterir | | /goal contract | Objective, criteria, constraints, checks, files ve limitleri gösterir | | /goal audit | Proof/evidence ve mevcut completion gate'i inceler | | /goal edit <objective> | Mevcut Goal'ın yeni revision'ını oluşturur | | /goal pause | Autonomous Goal continuation'ı duraklatır | | /goal resume | Uygun paused Goal'ı açıkça yeniden aktive eder | | /goal budget | Yerel execution limitlerini inceler/değiştirir | | /goal list | Proje çapındaki canlı Goal index'ini read-only gösterir | | /goal doctor | Live/archive/queue storage'ı yeniden yazmadan teşhis eder | | /goal add <objective> | Gelecek için inert bir Goal Contract sıraya ekler | | /goal queue | Queue'yu inceler, yeniden sıralar veya öğe kaldırır | | /goal next | Bitmemiş canlı Goal engellemiyorsa sıradaki Goal'ı promote eder | | /goal history | Arşivlenmiş Goal'ları inceler | | /goal restore <id> | Bitmemiş arşiv Goal'ını paused olarak geri yükler | | /goal clear | Mevcut canlı Goal'ı clear/archive eder |

İkinci bir Goal başlatabilir miyim?

Tek bir OpenCode session'ında en fazla bir bitmemiş canlı Goal bulunur. Böylece aynı session içinde iki autonomous controller'ın birbiriyle yarışması engellenir.

Bir Goal zaten active veya paused durumdaysa:

  • mevcut Goal'ı revize etmek istiyorsanız /goal edit <objective> kullanın;
  • ikinci Goal'ı daha sonra çalıştırmak için /goal add <objective> kullanın;
  • mevcut Goal'ı bilerek bırakıp/arşivleyip başka bir Goal başlatmak istiyorsanız /goal clear kullanın;
  • iki Goal'ı bilinçli olarak paralel çalıştırmak istiyorsanız ayrı bir OpenCode session'ı kullanın.

Queue için:

/goal add second objective
/goal queue
/goal next

/goal next, yalnızca bitmemiş canlı Goal promotion'ı engellemiyorsa sıradaki Goal'ı aktive eder.

Ayrı session'lar ayrı kalıcı Goal snapshot'larına sahiptir. Bu nedenle aynı proje dizininde farklı Goal'lar çalıştırabilirler; ancak iki session aynı proje dosyalarını değiştirirse normal workspace çakışmaları yine oluşabilir.

Pause ile normal chat farkı: açık devam isteği ve sıradan chat

/goal pause, kalıcı Goal durumunu paused yapar. /goal resume, Goal'ı yeniden aktive etmek için açık lifecycle komutu olarak kalır.

Kolaylık için devam et, continue, kaldığın yerden devam et veya resume gibi kısa ve belirsiz olmayan devam mesajları, Goal paused durumundayken resume niyeti olarak kabul edilir. Plugin bu niyeti Goal state'ini doğrudan değiştirmek yerine mevcut /goal resume command/ownership zinciri üzerinden geçirir.

Diğer foreground chat mesajları normal konuşma olarak kalır ve Goal'ı sessizce yeniden aktive etmez. Böylece rastgele chat lifecycle control'e dönüşmezken açık bir “devam et” isteği beklenen davranışı verir.

Aynı resume yolu fail-closed verifier kesintisi sonrasında da kullanılabilir. Timeout sınıfındaki bir verifier hatası önce taze bir verifier session'ında tek ve bounded bir otomatik retry alır; bu retry de başarısız olur ve Goal paused olarak kalıcılaştırılırsa verifier/provider kullanılabilir olduğunda /goal resume veya kısa ve açık bir devam mesajıyla completion yeniden denenebilir.

Goal Contracts

Tekrarlanabilir contract flag'leri success ve hard boundary'leri tanımlar:

--success "..."
--accept "..."
--constraint "..."
--non-goal "..."
--check "..."
--notify "command {reason} {goal}"
--contains "file::required text"
--unit "host komutu"
--fresh-session-per-unit
--continuous            # çalışmaya devam et; otomatik completion gate yok
--infinite              # --continuous alias'ı
--verified              # düzenlenen continuous Goal'ı verified completion'a döndür
--max-turns <n>
--max-tokens <n>
--max-minutes <n>
--max-cost <amount>

Yeni Goal'larda cumulative token limiti varsayılan olarak yoktur (maxTokens: 0). Toplam çalışma için açık bir runaway guard istediğinizde --max-tokens veya /goal budget --max-tokens kullanın; bu cumulative budget seçilen modelin güncel context/input penceresinden ayrıdır.

Continuous / infinite Goal'lar

Monitoring, generator, queue veya bilerek bir başarı koşuluna ulaşmadan çalışmaya devam etmesi gereken işler için Goal'ı continuous mode'da başlatın:

/goal gelen işleri sürekli işle --continuous

--infinite, --continuous için alias'tır. Bu modda Goal aktif kalır; autonomous continuation aynı objective, constraint, budget, restart recovery, no-progress koruması, provider güvenliği ve user-steering kurallarını kullanır, ancak otomatik verified completion kapalıdır. Model opencode_goal_complete çağırmaması için açıkça yönlendirilir; yine de çağırırsa host check veya semantic verifier çalıştırılmadan önce tool çağrısı reddedilir.

Continuous, "safety limitlerini yok say" anlamına gelmez: açık --max-turns, --max-tokens, --max-minutes, --max-cost, provider/usage limitleri, waiting-user durumu, tekrarlanan no-progress koruması, manuel /goal pause ve /goal clear normal şekilde işi durdurur veya askıya alır.

Mevcut continuous Goal'ı normal verified completion moduna döndürmek için açıkça edit edin:

/goal edit mevcut backlog'u bitir ve dur --verified

/goal status, /goal contract, /goal audit ve native sidebar mevcut mode'u gösterir. /goal add ... --continuous ile kuyruğa alınan Goal'lar promote edilirken mode'u korur.

Native OpenCode 2 sidebar ayrıca persisted Goal state'ten read-only telemetry gösterir: Goal id/revision, Goal yaşı ve account edilmiş model runtime, turn/token/cost ile finite/unlimited budget'lar, varsa seçili model/context telemetry, requirement/check/file proof sayıları, native Todo plan sayıları ve aktif Todo, son persisted host-progress/state-update yaşı, continuation/recovery/handoff durumu, stall-guard sayacı ve Goal queue. Host güvenilir veri persist etmediyse live TPS/provider phase veya sahte completion yüzdesi üretilmez.

--notify, Goal Contract'a opsiyonel ve kullanıcı tarafından yazılan yerel bir lifecycle komutu bağlar. Komut yalnız ilgili Goal state kalıcı olarak diske yazıldıktan sonra çalıştırılır. {reason} değeri completed, blocked, paused veya rejected; {goal} ise Goal ID ile değiştirilir. waiting_user, budget limit ve usage limit durumları paused reason değerini kullanır. Notification tamamen advisory'dir: komut hatası Goal state'ini veya completion sonucunu değiştiremez. Model-facing opencode_goal_* tool'ları bu komutu ayarlayamaz veya değiştiremez.

Örnek:

/goal release'i hazırla --check "npm test" --notify "my-notifier --goal {goal} --reason {reason}"

Tam objective her zaman gerekli bir semantic requirement olarak kalır. Dar kapsamlı kontroller ek proof obligations oluşturur; geniş sonucu asla değiştirmez veya yerine geçmez.

OpenCode 2 bounded per-unit session'lar

İş host tarafından gözlemlenebilen doğal unit'lere bölünüyorsa (ör. migration shard, paket, tenant veya numaralı batch), OpenCode 2 unit kimliği değiştiğinde aynı Goal'ı yeni bir native session'a devredebilir:

/goal tüm shard'ları migrate et \
  --unit "node scripts/current-shard.mjs" \
  --fresh-session-per-unit \
  --check "npm test"

İki flag birlikte zorunludur. --unit komutunun stdout'u yalnızca kimliktir; hangi harici unit'in aktif olduğunu söyler, completion kanıtı oluşturmaz ve requirement sağlamaz. Rotation yalnız temiz bir Goal-owned execution boundary sonrasında yapılır. Handoff OpenCode 2 native session.create ve kalıcı iki fazlı inbox transferini kullanır; eski session terminal handed_off olmadan target autonomous owner olamaz.

Goal ID, revision, contract, evidence, kümülatif usage ve budget session zinciri boyunca korunur. /goal status current unit ile root/previous/next session bağlantılarını gösterir. Paused, waiting-user, blocked/limited veya completed Goal rotate edilmez; final doğrulanmış completion yeni bir session açmak yerine zinciri bitirir.

/goal edit yeni bir revision oluşturur. Eski revision'a ait kanıtlar düzenlenmiş Goal'ı sessizce kanıtlayamaz.

Multi-turn cadence ve anti-batching

OpenCode Goals, açıkça birden fazla ayrı tur/cycle isteyen objective'ler için tasarlanmıştır.

Örnek:

/goal 10 ayrı goal turunda counter.json içindeki value değerini her tur tam +1 artır. Başlangıç 0, final 10. Tek seferde +10 yapma.

Bu tip objective'lerde plugin, mevcut revision boyunca host tarafından gözlenen workspace mutation fingerprint'lerini ve Goal progress bilgisini takip eder. Model işi tek seferde batch etmek yerine istenen per-turn birimini yapıp turu bitirmelidir.

Yalnızca final {"value":10} değeri, on ayrı +1 turunun gerçekleştiğini kanıtlamaz.

Native OpenCode Todo orchestration

Geniş multi-step işler için OpenCode Goals, OpenCode'un native Todo planlamasıyla koordineli çalışır ancak Todo state'i Goal proof olarak kabul edilmez.

Sınır nettir:

  • Todo text/status Goal evidence olmaz;
  • Todo completion tek başına Goal progress artırmaz;
  • Todo, kullanıcının yetki verdiği Goal scope'unu genişletemez;
  • güncel Todo planında pending veya in_progress iş varsa completion veto edilir;
  • tamamen bitmiş Todo planı bile Goal'ı kanıtlamaz;
  • eksik veya stale Todo telemetry daha yeni Goal revision'ını engelleyemez.

Completion bütünlüğü

Completion bir audit pipeline'ıdır:

  1. yapılandırılmış shell check'leri host üzerinde çalışır ve gerçek sonuç/output digest kaydedilir;
  2. tanımlı file contract'lar plugin tarafından proje sınırları içinde yeniden okunur;
  3. semantic requirement'lar ayrı, read-only bir verifier session'ına gönderilir;
  4. verifier citation'ları güncel files/evidence ile karşılaştırılır;
  5. zamansal requirement'lar için mevcut revision'a ait host-observed turn/progress gerçekleri kullanılabilir;
  6. stale, uydurulmuş, dolaylı veya başarısız evidence reddedilir;
  7. güncel native Todo işi yeniden kontrol edilir;
  8. completed state'i yazılmadan önce her gerekli ledger öğesi proven olmalıdır.

Verification kullanılamıyorsa, eksikse, stale/ambiguous ise veya lifecycle değişikliğiyle race oluşursa completion fail closed olur.

Verifier timeout / bounded retry / Goal paused kalıyor

Executor işi bitirmiş olsa bile bağımsız semantic verification timeout sınıfındaki bir altyapı hatasına ulaşırsa plugin timeout olan verifier child'ını abort edip temizler ve bir kez taze verifier session'ıyla otomatik retry yapar. Native OpenCode 2'de ana verifier deadline varsayılan olarak beş dakikadır ve verifierTimeoutMs plugin seçeneği veya OPENCODE_GOAL_VERIFIER_TIMEOUT_MS ile 60 saniyenin üzerine de çıkarılabilir. Tek taze-session retry ise yapılandırılmış deadline ile 60 saniyeden düşük olanına bounded kalır; üçüncü bir otomatik verifier denemesi yoktur.

Timeout dışındaki provider veya transport hataları otomatik retry edilmez. Bounded timeout retry da başarısız olursa Goal sonsuz completion retry döngüsüne girmek yerine paused olarak kalıcılaştırılır. Mevcut host evidence korunur.

Verifier/provider tekrar sağlıklı olduğunda:

/goal resume

kullanın. devam et veya continue gibi kısa ve açık bir mesaj da aynı resume yolunu kullanır.

Verifier kesintisi kanıtlanmamış bir Goal'ı hiçbir zaman completed olarak işaretlemez.

Persistence ve restart recovery

Project-local state:

.opencode/goals/
.opencode/goal-sequences/
.opencode/goal-locks/

Runtime; atomic writes, optimistic generation/CAS protection, per-session ownership, process leases, path/symlink escape protection, corrupt-state fail-closed handling ve process-restart recovery içerir.

Goal cumulative token/runtime budget'ları seçilen modelin mevcut context penceresinden bilinçli olarak ayrıdır. /goal status, host tarafından gözlenen full context pressure bilgisini ve model daha küçük bir input limiti sunuyorsa input-side pressure bilgisini ayrı gösterir. Ne zaman compact yapılacağına OpenCode karar vermeye devam eder.

Aktif bir Goal session'ı sahiplenmişken plugin, OpenCode'un generic post-compaction synthetic continue davranışını kapalı tutar ve tam bir kez Goal-owned guarded continuation yolundan devam eder. Böylece compaction sonrasında elle continue yazmak gerekmez ve iki ayrı continuation owner birbiriyle yarışmaz.

Sorun giderme

/goal yok veya command bridge modele ulaşıyor

Yeniden kurun/güncelleyin:

npx -y @bybrawe/opencode-goal@latest

Ardından:

  1. installer'ın exact package pin raporladığını doğrulayın;
  2. OpenCode 1.x için managed commands/goal.md köprüsünü; OpenCode 2.x için native plugins kaydını doğrulayın — V2 managed bridge gerektirmez;
  3. tüm OpenCode CLI/TUI/Desktop süreçlerini tamamen kapatıp yeniden açın;
  4. OpenCode'u external plugin'leri kapatan --pure ile başlatmayın;
  5. plugin-load hataları için OpenCode config diagnostics'i inceleyin.

Installer kullanıcıya ait bir commands/goal.md dosyasının üzerine yazmaz; OpenCode 2 böyle bir legacy dosyayı olduğu gibi bırakır ve plugin-native komutu kullanır.

Completion işi bittiği halde Goal paused

Şunları kontrol edin:

/goal status
/goal audit

Stop reason bounded otomatik retry sonrasında verifier infrastructure/timeout ise ve workspace zaten doğruysa istenen mutation'ları elle tekrar etmeyin. Completion yolunu yeniden denemek için /goal resume veya kısa ve açık bir devam mesajı kullanın.

Aynı session'da başka Goal başlatamıyorum

O session'da bitmemiş canlı bir Goal vardır. Şunlardan birini seçin:

/goal edit <replacement objective>
/goal add <future objective>
/goal clear

Ya da paralel çalışma için ikinci bir OpenCode session açın.

OpenCode Goals'u OpenCode Loop ile kullanmak

OpenCode Loop ayrı ve tamamlayıcı bir eklentidir. Loop artık varsayılan olarak yalnızca Loop'u kurar; --with-goals açıkça verilmedikçe OpenCode Goal'ı kurmaz, algılamaz, güncellemez, migrate etmez veya değiştirmez.

Önerilen bağımsız kurulum:

npx -y @bybrawe/opencode-loop@latest
npx -y @bybrawe/opencode-goal@latest

Loop üzerinden isteğe bağlı birleşik kurulum:

npx -y @bybrawe/opencode-loop@latest --with-goals

Önerilen görev ayrımı:

  • OpenCode Goals — kalıcı /goal contracts, host evidence, completion verification, false-completion protection, revision isolation, restart recovery ve ordered Goals.
  • OpenCode Loop — /loop, scheduled command/shell jobs, compaction scheduling ve timer/idle-driven repetition altyapısı.

Loop'un eski deneysel /loop-goal* komutları artık varsayılan olarak kurulmaz. Yalnızca uyumluluk için --with-loop-goals ile açıkça etkinleştirilebilir; yeni kurulumlarda bunun yerine bu ayrı Goal eklentisini kullanın.

Aynı OpenCode session'ında aynı iş üzerinde /goal ile prompt üreten bir Loop'u birlikte çalıştırmayın. İkisi de autonomous continuation yapabilir ve tur başlatmak için yarışabilir. Ayrı session kullanın veya Goal bitene kadar prompt loop'u pause/remove edin.

Paket ve release kalitesi

npm paketi:

@bybrawe/opencode-goal

Repository; deterministic regression tests, adversarial eval'ler, minimum/current OpenCode compatibility lane'leri, real-host lifecycle/semantic/Todo/steering canary'leri, restart recovery testleri, cross-platform package smoke testleri, dedicated server-entry regression coverage ve installer/update/uninstall testleri içerir.

Release geçmişi için CHANGELOG.md, release süreci için RELEASING.md dosyasına bakın.

Kaldırma

npx ile kuruldu/güncellendiyse:

npx -y @bybrawe/opencode-goal@latest --uninstall

Installer CLI global kuruluysa:

opencode-goal --uninstall
npm uninstall -g @bybrawe/opencode-goal

Uninstall sırasında proje Goal state'i bilerek silinmez:

.opencode/goals/
.opencode/goal-sequences/
.opencode/goal-locks/

Project-local Goal state/history'i gerçekten silmek istediğinizde bu dizinleri kendiniz kaldırın.

Lisans

MIT