mirror of https://github.com/NeuralNomadsAI/CodeNomad.git synced 2026-09-13 11:50:37 +00:00

mirror of https://github.com/NeuralNomadsAI/CodeNomad link from https://www.reddit.com/r/opencodeCLI/comments/1txd7ua/comment/opvreck/

Find a file

fitzgpt 14586cb33e feat(ui): add Turkish localization (#662 ) Adds Turkish (tr-TR) as a supported UI language, following the same structure as the existing German/Nepali localization (#523). ## What's included - `packages/ui/src/lib/i18n/messages/tr/` — all 16 message modules + `index.ts`, mirroring the English files. 1,602/1,602 keys translated (verified against `en/`: no missing, no extra, every `{placeholder}` preserved). - `packages/ui/src/lib/i18n/index.tsx` — `tr` added to the `Locale` union, `SUPPORTED_LOCALES`, and `localeLoaders` (lazy import, same as other locales). - `packages/ui/src/components/locale-selector.tsx` — `Türkçe` added to the language options. - `CONTRIBUTING.md` — translation-files row updated to list the current locale set. ## Translation conventions Following the repo's i18n rule ("add to `en/` first, then every other locale"), plus the convention visible in existing locales: - Developer jargon stays English: session, workspace, instance, provider, agent, prompt, token, diff, commit, worktree, branch, SideCar, plugin. - Product names and acronyms stay literal: CodeNomad, OpenCode, GitHub, VS Code, API, CLI, SSH, TLS, TTS/STT. - Turkish orthography (İ/ı casing, apostrophe suffixes on jargon: session'ın, agent'ler). ## Verification - `npx tsc --noEmit -p tsconfig.json` (packages/ui) — pass - `npx vite build` (packages/ui) — pass (build also exercises `mergeMessageParts`, so no duplicate keys) - Runtime check on `vite dev`: with a Turkish browser locale the app auto-detects and renders fully in Turkish; the language picker lists and selects `Türkçe` (screenshots below) ## Screenshots Before — English UI (fresh profile, en-US locale): <img width="640" alt="before-english" src="https://raw.githubusercontent.com/fitzgpt/CodeNomad/tr-evidence/evidence/cn-before-english-home.png" /> After — Turkish UI (auto-detected from browser locale): <img width="640" alt="after-turkish" src="https://raw.githubusercontent.com/fitzgpt/CodeNomad/tr-evidence/evidence/cn-after-turkish-home.png" /> After — language picker with Türkçe selected: <img width="640" alt="after-picker" src="https://raw.githubusercontent.com/fitzgpt/CodeNomad/tr-evidence/evidence/cn-after-turkish-picker-open.png" /> --------- Co-authored-by: fitzgpt <fitzgpt@users.noreply.github.com>		2026-08-26 19:14:20 +02:00
.github	feat(ui): manage visible provider models (#637 )	2026-08-13 09:33:23 +01:00
.opencode	feat(yolo): move permission auto-accept (Yolo) to the server (#561 )	2026-07-08 21:13:44 +02:00
dev-docs	build: publish deb and portable tar.gz Linux artifacts (#492 )	2026-07-12 19:29:33 +02:00
docs	feat(ui): support bracket math delimiters (#588 )	2026-07-14 14:00:26 +02:00
images	Move screenshots to correct folder	2025-11-21 21:59:58 +00:00
packages	feat(ui): add Turkish localization (#662 )	2026-08-26 19:14:20 +02:00
scripts	chore: TASK-075 automate Winget updates on release (#513 )	2026-06-03 09:03:46 +02:00
temp	Bump to v0.11.2	2026-02-17 18:47:21 +00:00
.gitignore	chore: ignore local artifacts and add cloudflare lockfile	2026-01-22 16:42:47 +00:00
AGENTS.md	Improve compact mobile UI controls (#564 )	2026-06-19 13:52:26 +01:00
BUILD.md	build: publish deb and portable tar.gz Linux artifacts (#492 )	2026-07-12 19:29:33 +02:00
CONTRIBUTING.md	feat(ui): add Turkish localization (#662 )	2026-08-26 19:14:20 +02:00
LICENSE	chore(license): add MIT license	2026-02-02 11:22:49 +00:00
package-lock.json	Bump version to 0.19.0	2026-08-13 09:39:25 +01:00
package.json	Bump version to 0.19.0	2026-08-13 09:39:25 +01:00
README.md	docs: fix broken star history chart (#654 )	2026-08-17 10:24:23 +02:00
THIRD_PARTY_NOTICES.md	feat(usage): show provider quota in session status (#584 )	2026-07-15 10:25:00 +01:00

README.md

CodeNomad

The AI Coding Cockpit for OpenCode

CodeNomad transforms OpenCode from a terminal tool into a premium desktop workspace — built for developers who live inside AI coding sessions for hours and need control, speed, and clarity.

OpenCode gives you the engine. CodeNomad gives you the cockpit.

Features

🚀 Multi-Instance Workspace
🌐 Remote Access
🧠 Session Management
🎙️ Voice Input & Speech
🌳 Git Worktrees
💬 Rich Message Experience
🧩 SideCars
⌨️ Command Palette
📁 File System Browser
🔐 Authentication & Security
🔔 Notifications
🎨 Theming
🌍 Internationalization

Getting Started

🖥️ Desktop App

Available as both Electron and Tauri builds — choose based on your preference.

Download the latest installer for your platform from Releases.

Platform	Formats
macOS	DMG, ZIP (Universal: Intel + Apple Silicon)
Windows	NSIS Installer, ZIP (x64, ARM64)
Linux	Tauri deb, Electron portable tar.gz (x64)

The Tauri deb is currently built and installation-tested on Ubuntu 24.04. Compatibility with older Debian-based distributions is not yet guaranteed.

💻 CodeNomad Server

Run as a local server and access via browser. Perfect for remote development.

npx @neuralnomads/codenomad --password <your-password> --launch

Authentication required: The server requires a password on first run. You can pass it via --password, the CODENOMAD_SERVER_PASSWORD environment variable, or create an auth.json file (see Server Documentation).

Self-signed certificate: On first launch with HTTPS enabled (the default), your browser will show a "Your connection is not private" warning. This is expected — the server generates a local self-signed certificate automatically. Click Advanced → Proceed to localhost to continue. For local-only use without the warning, run with --https=false --http=true.

See Server Documentation for flags, TLS, auth, and remote access.

🧪 Dev Releases

Bleeding-edge builds from the dev branch:

npx @neuralnomads/codenomad-dev --password <your-password> --launch

SideCars

SideCars let you open local web tools inside CodeNomad as tabs.

Configuration

Name: Display name used in CodeNomad
Port: Local HTTP or HTTPS service running on 127.0.0.1:<port>
Base path: Mounted under /sidecars/:id
Prefix mode:
- Preserve prefix forwards the full /sidecars/:id/... path upstream
- Strip prefix removes /sidecars/:id before forwarding the request upstream

VSCode (OpenVSCode Server)

Run with Docker:

docker run -it --init -p 8000:3000 -v "${HOME}:${HOME}:cached" -e HOME=${HOME} gitpod/openvscode-server --server-base-path /sidecars/vscode

Add SideCar as:

Name: VSCode
Port: http://127.0.0.1:8000
Base path: /sidecars/vscode
Prefix mode: Preserve prefix

Terminal (ttyd)

Run with:

ttyd --writable zsh

Add SideCar as:

Name: Terminal
Port: http://127.0.0.1:7681
Base path: /sidecars/terminal
Prefix mode: Strip prefix

Requirements

OpenCode CLI — must be installed and in your PATH
Node.js 18+ — for server mode or building from source

Development

CodeNomad is a monorepo built with:

Package	Description
packages/server	Core logic & CLI — workspaces, OpenCode proxy, API, auth, speech
packages/ui	SolidJS frontend — reactive, fast, beautiful
packages/electron-app	Desktop shell — process management, IPC, native dialogs
packages/tauri-app	Tauri desktop shell (experimental)

Quick Start

git clone https://github.com/NeuralNomadsAI/CodeNomad.git
cd CodeNomad
npm install
npm run dev

Troubleshooting

macOS: "CodeNomad.app is damaged and can't be opened"

Gatekeeper flag due to missing notarization. Clear the quarantine attribute:

xattr -dr com.apple.quarantine /Applications/CodeNomad.app

On Intel Macs, also check System Settings → Privacy & Security on first launch.

Linux (Wayland + NVIDIA): Tauri App closes immediately

WebKitGTK DMA-BUF/GBM issue. Run with:

WEBKIT_DISABLE_DMABUF_RENDERER=1 codenomad-tauri

See full workaround in the original README.

Community

Built with ♥ by Neural Nomads · MIT License