opencode/.opencode/glossary/he.md

he Glossary

Sources

• Hebrew Academy approved IT terminology: https://terms.hebrew-academy.org.il/Millonim/ShowMillon?KodMillon=192
• Firefox Hebrew localization corpus: https://github.com/mozilla-l10n/firefox-l10n/tree/main/he
• KDE Hebrew localization team and corpus: https://l10n.kde.org/team-infos.php?teamcode=he
• Community-maintained VS Code Hebrew language pack: https://github.com/AMAARETS/vscode-language-pack-he
• Microsoft Hebrew developer documentation for Git terminology: https://learn.microsoft.com/he-il/power-platform/alm/tutorials/github-actions-deploy
• W3C guidance for bidirectional text: https://www.w3.org/International/articles/strings-and-bidi/

Do Not Translate (Locale Additions)

• OpenCode (preserve casing in prose and UI copy)
• API, MCP, LSP, OAuth, Git, model names, and provider names
• Commands, flags, keyboard shortcuts, file paths, URLs, identifiers, hashes, and code literals
• Keep commit and diff when they name the exact Git artifact or operation

Preferred Terms

English / Context	Preferred	Notes
session	הפעלה	Use שיחה only when the source specifically means a chat or conversation
workspace	סביבת עבודה
terminal	מסוף	Prefer the established Hebrew term over transliteration
command	פקודה
provider	ספק	Use ספק מודלים where the bare noun is ambiguous
model	מודל
API key	מפתח API	Keep the acronym in Latin letters
plugin	תוסף
repository	מאגר	Use מאגר Git where context is ambiguous
branch	ענף
context	הקשר	Use חלון הקשר for context window
tokens	אסימונים

Guidance

• Prefer natural modern Israeli Hebrew over word-for-word translation or obscure coined terms.
• Use short action verbs for controls and translate complete phrases in context.
• Keep recognized developer acronyms and exact Git vocabulary in Latin script instead of phonetic transliteration.
• Treat embedded code, paths, commands, shortcuts, hashes, model IDs, and other Latin technical artifacts as LTR content inside the RTL interface.
• Keep recurring concepts consistent and do not collapse session, chat, run, and launch into one Hebrew term.

Avoid

• Avoid transliterations such as טרמינל, פלאגין, and קומנד when מסוף, תוסף, and פקודה are clear.
• Avoid translating commit as התחייבות.
• Avoid inventing Hebrew expansions for API, MCP, or LSP.