RTL language support (Persian/Arabic) - characters appear reversed and disconnected #16875

Activity

1. ajomik

   added

   bugSomething isn't workingSomething isn't working

   on Mar 10, 2026
2. github-actions

   assigned

   kommander

   on Mar 10, 2026
3. github-actions

   added

   opentuiThis relates to changes in v1.0, now that opencode uses opentuiThis relates to changes in v1.0, now that opencode uses opentui

   windows

   on Mar 10, 2026
4. github-actions commented on Mar 10, 2026

   

   github-actionsBot

   on Mar 10, 2026 – with GitHub Actions

   Contributor

   More actions

   This issue might be a duplicate of existing issues. Please check:

   • [FEATURE]: Support for RTL languages #6284: [FEATURE]: Support for RTL languages
   • [FEATURE]:RTL support! #9255: [FEATURE]: RTL support!
   • feat(i18n): Add RTL (Right-to-Left) support for Arabic and other RTL languages #10908: feat(i18n): Add RTL (Right-to-Left) support for Arabic and other RTL languages
   • [FEATURE]: Add RTL support in UI to Hebrew & Arabic #14257: [FEATURE]: Add RTL support in UI to Hebrew & Arabic

   Please review these issues and consider commenting on an existing one if it covers your use case.
5. uriva

   added a commit that references this issue on Apr 11, 2026

   fix: RTL text layout support in web UI (anomalyco#16875)

   ...

   9b6be32
6. thdxr

   removed

   bugSomething isn't workingSomething isn't working

   opentuiThis relates to changes in v1.0, now that opencode uses opentuiThis relates to changes in v1.0, now that opencode uses opentui

   windows

   on May 3, 2026
7. hbx12 commented on May 30, 2026

   

   hbx12

   on May 30, 2026

   More actions

   I'd like to investigate this issue and work on a fix.

   I'm currently helping with Arabic/RTL improvements and would like to start by reproducing the problem and documenting affected areas before proposing changes.

   👍React with 👍1Reacted by Ahmed Morsi
8. razavioo commented on Jul 29, 2026

   

   razavioo

   on Jul 29, 2026

   More actions

   Community plugin available: opencode-rtl

   For those looking for RTL support, we've built an OpenCode plugin that automatically applies Unicode bidi isolation (RLI/LRI/PDI) to the AI's responses and system prompts.

   npm install opencode-rtl

   // opencode.json
   {
     "plugin": [
       ["opencode-rtl", { "language": "auto" }]
     ]
   }

   What it fixes today:

   • Injects RTL system prompts so the AI responds in your language
   • Protects inline code (console.log()) and markdown blocks from getting scrambled by wrapping them in LTR isolates
   • Works out-of-the-box for Arabic, Persian, Hebrew, Urdu, etc.
   • Fixes character ordering and mixed-direction (BiDi) text issues

   Current limitations:

   • Right-alignment: The plugin fixes the ordering of words and code (which fixes a lot of the unreadable output), but the text is still left-aligned. Full right-alignment requires native support in the renderer (like CSS dir="rtl" as discussed in this issue, or native alignment in the CLI TUI).
   • Streaming: It formats the text after the response completes. (We are proposing a streaming hook to fix this).

   Repo: https://github.com/razavioo/opencode-rtl
9. razavioo commented on Sep 27, 2026

   

   razavioo

   on Sep 27, 2026

   More actions

   The reversed/disconnected characters issue happens because the terminal doesn't know which segments are RTL. The opencode-rtl plugin fixes this by wrapping RTL segments with Unicode bidi isolation characters.

   Install:

   npm install opencode-rtl
   

   Configure (opencode.json):

   {
     "plugin": [["opencode-rtl", { "language": "fa" }]]
   }

   Or for OpenCode 2:

   {
     "plugins": [{ "package": "opencode-rtl", "options": { "language": "fa" } }]
   }

   Important: your terminal must support Unicode bidi rendering. Recommended terminals: WezTerm, iTerm2, Windows Terminal, or Ghostty.
10. neriousy

    marked Persian/Arabic (RTL) text is not displayed correctly in opencode TUI #32984 as a duplicate of this issue on Oct 1, 2026
11. neriousy

    marked [FEATURE]:افزودن تنظیمات اختصاصی برای زبان‌های RTL #36885 as a duplicate of this issue on Oct 1, 2026
12. neriousy

    marked Support RTL/BiDi text rendering in CLI output #38524 as a duplicate of this issue on Oct 1, 2026
13. neriousy

    marked RTL/bidi support for mixed Arabic/English chat output #40004 as a duplicate of this issue on Oct 1, 2026
14. neriousy

    marked RTL/bidi broken for mixed Arabic-script + Latin text in TUI #40286 as a duplicate of this issue on Oct 1, 2026
15. neriousy

    marked [FEATURE]: RTL (Right-to-Left) / Bidirectional text support for TUI input and chat rendering #51005 as a duplicate of this issue on Oct 1, 2026
16. neriousy

    marked Arabic Character Bug #47982 as a duplicate of this issue on Oct 20, 2026
17. neriousy

    marked [FEATURE]:Persian/Farsi text is not displayed RTL (right-to-left) correctly #50746 as a duplicate of this issue on Oct 20, 2026
18. opencodejr commented on Oct 29, 2026

    

    opencodejrBot

    on Oct 29, 2026

    More actions

    Thanks for the report and the screenshot!

    This was filed before OpenCode 2 was released, so it's about OpenCode v1 (versions 0.x/1.x). v1 now only gets fixes for critical bugs, so RTL/bidi rendering is unlikely to be added there.

    We'd encourage you to upgrade to v2 (@opencode/cli, the opencode command). The v2 desktop/web app has RTL support (#40372). The v2 terminal UI doesn't handle bidirectional text yet, though, so in the terminal Persian/Arabic may still look wrong.

    In the meantime, the community plugin opencode-rtl mentioned above may help. It adds bidi isolation marks to responses, which fixes much of the character ordering but not the alignment.

    Related issues:

    • [FEATURE]: Support for RTL languages #6284: RTL support for input and responses (closed automatically for inactivity; comments say it's still not solved)
    • feat(i18n): Add RTL (Right-to-Left) support for Arabic and other RTL languages #10908: RTL support for Arabic, Persian and other RTL languages
    • [FEATURE]:RTL support! #9255: RTL support in the CLI and desktop
    • [FEATURE]: Add RTL support in UI to Hebrew & Arabic #14257: RTL support in the UI

    If you think this is critical, or you see the same problem on v2, please reply here with your opencode --version output.
19. opencodejr

    added

    pending close

    triaging

    on Oct 29, 2026
20. opencodejr

    closed this as not plannedon Oct 30, 2026
21. opencodejr commented on Oct 30, 2026

    

    opencodejrBot

    on Oct 30, 2026

    More actions

    Closing this as not planned. The report is about OpenCode v1, which only gets critical fixes, and we didn't hear back about whether it also happens on v2.

    The v2 terminal UI doesn't render RTL text properly yet either. If you see this on v2, please open a new issue with your opencode --version output. You can also try the community plugin opencode-rtl, which fixes much of the character ordering. Thanks again for reporting it!