01b20b5b78
## Summary
- Qualify OpenCode **2.1.3** (latest stable, 22 October) with the
existing locked **2.1.0 client/plugin** dependencies, and **recommend**
it.
- Keep the technical **minimum at 2.1.2**: nothing CodeNomad consumes
changed, so the minimum has no new reason to move.
- A 2.1.2 daemon stays ready and gets an optional upgrade offer. 2.1.3
is the `tested` version. Newer and custom labels keep authenticated
contract recognition.
- The reviewed-contract fast path lists 2.1.3 beside the 2.1.2 minimum.
- The recommended version is updated in the help (all ten locales), both
READMEs, `dev-docs/OPENCODE_COMPATIBILITY.md` and the architecture
skill.
## Contract review (v2.1.2 → v2.1.3, 66 commits)
- **Authenticated OpenAPI:** 119 → **121 paths**, 144 → **146
operations**. Every consumed operation is unchanged. The only changes:
- added `GET /api/experimental/voice/models`;
- added `POST /api/experimental/voice/session/{sessionID}/instructions`;
- an optional hosted `session.id` in the `POST
/api/experimental/voice/session` response.
None of these is on the instance proxy allowlist, so they stay closed.
- **Published declarations:** the client adds only `voice.models` /
`voice.instructions`. The schema changes only typing (agent `color`
decoding, `Durable` as a tagged union). The plugin is unchanged.
- **Windows managed services** move their default port from **45278 to
28894** ([#57428](https://github.com/anomalyco/opencode/pull/57428)).
CodeNomad discovers the daemon through the selected CLI's `service
status` and the service registration, and assumes no port.
- Live check: this machine's shared daemon was upgraded to 2.1.3 and
restarted on 28894, and the running CodeNomad desktop kept working
through it.
- **Core:** mostly refactors, plus behaviour fixes that the native
suites below exercise:
- compaction summary output limit;
- `keepID` validated as a message ID;
- MCP media kept out of attachments;
- only changed instruction entries resent;
- relative-directory V1 migration;
- legacy `apply_patch` permission mapped to `edit`.
## Isolated Windows qualification
Base: dev `333d73452`, rebased on `853b14f2f` (#1097) for the final UI
unit run; Node **24.20.0**; exact official CLI **2.1.3**; unchanged
locked client/plugin **2.1.0**.
- **Build and checks:** production server/UI/native plugin builds,
server and root typechecks, native bundle guard.
- **Native runtime (9/9):**
- Code Mode job ordering, plugin runtime, automation;
- complete pruning, history, ownership, worktree and event relay;
- loaded-only pending snapshot;
- Missions contract, family control, native and Compare/Wayfinder
trajectory.
- **Sessions (15/15):** environment, fork, aside, interrupt, lifecycle,
blank cleanup, prompt skills, provider usage/accounts/selection, service
usage, web search, plugin packages, output limit, Promise-tool failure.
- **Recurring (5/5):** all **11 recurring Mission journeys**, subagent
depth, **2 MiB** compaction, permission receipts.
- **Migrations (9/9):**
- history from **2.0.3, beta-19271, 2.0.32, 2.1.0, 2.1.1 and 2.1.2** to
2.1.3;
- Git degraded/init;
- temporary workspaces.
- **Installation (3/3), with the 2.1.3 recommendation:**
- fresh install of the 2.1.2 minimum;
- native **2.0.15 → 2.1.3** upgrade, after which the already-running
daemon keeps its PID and 2.0.15 version;
- explicit OpenCode **1.18.10 → 2.1.3** replacement.
- **After the recommendation change:**
- admission/transport/update/setup units **36/36**;
- full server **2,463 passed, 8 skipped**, no failure or cancellation;
- UI units **1,694/1,694** (with #1097);
- focused browser **126/126**;
- native pruning with the real rendered UI;
- the exact CI invocation of the Code Mode regression (without tsx);
- ten-locale help checks.
The UI unit run on `333d73452` itself had two failures, in
`instances-pending-compaction.test.ts` (`toast.dismiss is not a
function`). They come from #1096 and also fail on unmodified `dev`;
#1097 fixes that fixture.
This is Windows automation evidence. In CI, `latest` now resolves to
2.1.3: the compatibility job runs the native suites against the minimum
and latest on Windows, and the migration and Git-degraded certification
runs them on Ubuntu, Windows and macOS. WSL, packaged desktop,
installers/updater end-to-end and real mobile devices keep their
separate release gates.
6.2 KiB
CodeNomad kurulumu
Yerel bir masaüstü ana bilgisayarı seçin veya bağımsız sunucu'yi çalıştırın. Her iki durumda da OpenCode, paylaşılan yerel hizmete ve geçmişe sahiptir.
Masaüstü indirmeleri
- En son sürümü'yi açın.
- İşletim sisteminize ve işlemcinize uygun yapıyı seçin.
- ZIP'i çıkarın veya platform paketini kurun/çalıştırın, ardından CodeNomad'i başlatın.
| Platform | Electron sürümü | Tauri sürümü | Platform notları |
|---|---|---|---|
| macOS | ZIP, Intel veya Apple Silicon | ZIP, Intel veya Apple Silicon | Paket çalışma zamanı için macOS 13.5 veya üzeri gereklidir. |
| Windows | ZIP, x64 | Yükleyici, x64 | Windows 10 veya sonrası; Tauri WebView2 kullanır. |
| Linux | Debian paketi, x64 | AppImage, x64 | Ubuntu 24.04'te oluşturulmuş ve test edilmiştir; eski dağıtımlarla uyumluluk garanti edilmez. |
Masaüstü sürümleri, arka uç ve OpenCode yükleyicisinin ihtiyaç duyduğu çalışma zamanı kaynaklarını içerir; dolayısıyla bunları kullanmak için ayrı bir Node.js/npm kurulumuna ihtiyacınız yoktur. Git pakete dahil değildir. Yerel tarayıcı otomasyonu Electron ve Windows Tauri'de desteklenir; diğer Tauri platformları iframe önizlemelerini kullanır.
Başlatma sırasında engellenen doğrulanmış bir indirme için, bkz. platform sorunlarını giderme. Asla güvenilmeyen bir arşivi yalnızca bir uyarıyı atlamak için çalıştırmayın.
Linux üzerine kurulum
İndirilen sürümün bulunduğu klasörde gerçek sürümü ve dosya adını kullanın:
sudo apt install ./CodeNomad-Electron-linux-x64-<version>.deb
Tauri AppImage için:
chmod +x CodeNomad-Tauri-linux-x64-<version>.AppImage
./CodeNomad-Tauri-linux-x64-<version>.AppImage
FUSE kullanılamıyorsa AppImage'ın çıkarma ve çalıştırma modunu kullanın:
./CodeNomad-Tauri-linux-x64-<version>.AppImage --appimage-extract-and-run
Electron Debian kurulumu, Chromium'un korumalı alanını yapılandırır. Kurulum geçici çözümü olarak korumalı alanı devre dışı bırakmayın. Linux Tauri grafik sorunlarının hedefli WebKit geçici çözümü'si vardır.
Gereksinimler
| Gereksinim | Nerede bulunması gerektiği | Mevcut gereksinim |
|---|---|---|
| OpenCode CLI | Geçerli olduğu yerde seçilen WSL dağıtımı da dahil olmak üzere seçilen yürütme ana bilgisayarı | Minimum 2.1.2; 2.1.3 önerilen/uygun hedeftir. Daha yeni veya özel sürümler, test edilmemiş sürüm yasağı yerine sözleşme doğrulamasından geçer. |
| Git | CodeNomad arka uç hesabının PATH'si |
Depo kimliği, Git işlemleri ve çalışma ağaçları için gereklidir. |
| Node.js/npm | Bağımsız sunucu ve kaynak derleme ana bilgisayarı | Node.js 24 LTS; tekrarlanabilir kaynak derlemeleri .node-version (24.20.0) kullanır. Masaüstü çalışma zamanı/kurulum kaynaklarına dahildir. |
| Çalışma alanı klasörü | Arka uçtan erişilebilen disk | Uzak bir tarayıcı tarafından çıkarılan yerel cihaz klasörü değil, açıkça açılmış bir fiziksel klasör. |
Windows'ta, komut satırı/üçüncü taraf erişimi etkinleştirilmiş olarak Windows için Git'yi yükleyin. Kullanıcı tarafından yazılabilen, kullanıcı başına kurulum yeterlidir. MacOS/Linux'ta Git'in platform talimatlarını kullanın.
PATH'yi değiştirdikten sonra, masaüstü uygulamasından tamamen çıkıp yeniden başlatın veya amaçlanan hesap altında bağımsız arka ucu yeniden başlatın. Bir tarayıcının yeniden yüklenmesi arka uç ortamını güncellemez. Yalnızca WSL içinde bulunan Git, Windows arka ucunun Git gereksinimini karşılamaz.
Git olmadan, yine de fiziksel bir klasörü açabilir ve aracıdan kurulum yardımı istemek de dahil olmak üzere yalnızca dizin konuşmalarını kullanabilirsiniz. Depo/çalışma ağacı işlemleri kullanılamıyor; oturum erişimi tam olarak bu klasörle sınırlı kalır. CodeNomad, istemlerden/özel komutlardan önce aracıya arka uç Git kullanılabilirliği hakkında bilgi verir ve kurtarma sonrasında bu uyarıyı kaldırır. Aracının yürütme ana bilgisayarı arka uç ana bilgisayarından farklı olabilir; bu nedenle Git'i yalnızca aracının kabuğu için değil, arka uç için de yükleyin.
İlk başlatmada OpenCode'u seçin
- Kurulumda, mevcut uyumlu bir yürütülebilir dosyayı seçin veya sunulan OpenCode kurulum işlemini kullanın.
- Bir projeyi açmadan önce çalışma zamanı durumunu doğrulayın.
- Yürütülebilir dosyayı, kurulumu ve paylaşılan hizmeti ayrı ayrı yönetmek için Preferences → OpenCode öğesini tekrar ziyaret edin.
CodeNomad, PATH üzerinde uyumlu yürütülebilir dosyaları tercih eder ve açıkça seçilmiş bir yürütülebilir dosyayı destekler. PATH daha eski bir OpenCode başlatıyorsa kurulum, npm ile kurulmuş bir OpenCode 1.x'i onaydan sonra değiştirmeyi ya da başka bir yolla yapılmış bir kurulumun yanına, ona hiç dokunmadan CodeNomad için OpenCode 2 kurmayı önerir; bkz. OpenCode kurulumu. CLI'nin kurulması/güncellenmesi, halihazırda çalışan bir paylaşılan hizmeti sessizce yeniden başlatmaz. Yeniden başlatma/yeniden yükleme sonuçları, WSL ve oturum ortamı için bkz. OpenCode kurulumu.
Bunun yerine bir tarayıcı kullanın
Node.js/npm, Git ve OpenCode'u sunucu ana bilgisayarına yükleyin, ardından sunucu başlatma prosedürlerini kullanın. Basılı adres, yapılandırılmış kimlik doğrulama ve güvenilir bir sertifika ile bağlanın. Bir tarayıcının/PWA'nin canlı bir arka uca ihtiyacı vardır; projelerinizin çevrimdışı bir kopyası değildir.
Bağlantı noktaları, bağlamalar ve TLS için doğrudan erişim'yi kullanın. Bir cihazı gelen bağlantı noktalarını açmadan eşleştirmek için Uzaktan Kontrol'yi kullanın. Geliştirme ve paketleme komutları için bkz. kaynak derlemeleri.