[Feature Request] Support clickable file paths in output for quick navigation

[140270103901]

First of all, thank you for your hard work on this project! It has been very helpful to me.

Is your feature request related to a problem?
Currently, the file paths displayed in the output are rendered as plain text. As shown in the screenshot below, I cannot interact with the path spaic/Neuron/Encoders.py to open the file directly.

Describe the solution you'd like
I would like to suggest adding support for clickable file paths. Ideally, the file path should be rendered as a hyperlink so that I can use Ctrl + Left Click to jump directly to the corresponding file in the editor (similar to how the VS Code terminal handles paths).

Additional context
Expected: The file path is highlighted/underlined and clickable (official opencode plugin in vscode).

Current: The file path is plain text (this plugin in pycharm).

Thank you for considering this request!

[LaiZhou]

em, will try to support it on next version 1.0.4.

[140270103901]

em, will try to fix it on next version 1.0.4.

thanks

[LaiZhou]

@140270103901 After evaluating this, I’m concerned that implementing this feature might not be the best approach for the main version due to a few technical constraints:

Event Conflicts: Clicking anchor links within the JetBrains terminal creates a conflict between the terminal's native click actions and the OpenCode TUI event response handling.

Cursor Interference: Interaction via clicking causes the cursor to reposition automatically, which interferes with JetBrains' internal components and can lead to unstable behavior.

That being said, if you would like to test it regardless of these side effects, I can provide a specific version/branch that supports anchor link jumps. Please just be aware that this will likely result in a degraded user experience and more stability issues.

[140270103901]

@LaiZhou Thanks again for your detailed explanation and fast response to this request.

Given the potential stability issues you mentioned, I agree that this feature is not worth the trade-off. Stability is definitely the priority. The current functionality serves my needs well, so there is no need to create a specific branch for this.

I really appreciate your hard work on this project. Please feel free to close this issue as you see fit.

[LaiZhou]

@140270103901
OpenCode_UI-1.0.4.zip

This is the 1.0.4 beta version, which I am currently using in my daily workflow. Feel free to try it out and let me know if you have any feedback or encounter any issues.

1.0.4

• Added support for clickable file links (@file#Lx-y) in terminal with optimized cursor handling.

• Fixed diff logic for Chinese/Unstaged files using baseline snapshots to prevent data loss on reject.

[LaiZhou]

@140270103901

OpenCode_UI-1.0.4.zip

Version 1.0.3 is currently under review. In the meantime, I am providing a v1.0.4 pre-release version. It includes several functional enhancements that I’ve found incredibly useful in my own daily workflow:

🚀 v1.0.4 Highlights
Session Auto-Resume: New terminals now automatically load the most recent session history, so you can pick up right where you left off.

Task Notification: Added a system notification for when the AI completes a task (transitions from Busy to Idle).

Stability Improvements: Fixed the issue where moving a terminal tab would cause a disconnection.

Enhanced Diff View: Fixed garbled Chinese text and improved the handling of unstaged files.

Reliable Input: Improved prompt injection reliability by leveraging the TUI API (as discussed).

Clickable Links: Added support for clickable file links (@file#Lx-y) directly within the terminal.

[140270103901]

@LaiZhou , thanks a lot for sharing the 1.0.4 pre-release version! I’ve installed it and tested the updates.

1.Clickable Links issue: I've looked further into this and realized the behavior stems from the underlying differences in how various IDEs handle terminal editor integration. The current implementation in the plugin is actually quite practical and fits my workflow well now. We can consider this part resolved. Thank you for looking into it.

2.Feedback on "Feature 4: Review Diffs": I do have one question regarding the auto-diff feature.

• Context: I am running OpenCode in PyCharm 2025.3.1 and asked the agent to modify a python script.

• Issue: When the Agent finishes a task, the diff viewer does not trigger/open automatically. I only see the file path and modification lines output in the terminal. I tested this on both versions 1.0.2 and 1.0.4, and the behavior remains the same.

• Question: Is this the expected behavior for the beta? Or should I be adding specific configurations to Agents.MD to enable the auto-trigger?

Thanks again for your responsiveness and the great work!

[LaiZhou]

@140270103901 Regarding the issue you mentioned, I also primarily use PyCharm 2025.3.1 connected with OpenCode Desktop, and I've confirmed that the Diff panel works as expected on my end.

Also, please make sure you are using version 1.0.4 mentioned in my previous message.

To help troubleshoot this further, could you please provide the following details:

Detailed Workflow: What are the specific steps you take to trigger the Diff?

Git Status: Is the file currently tracked by Git? Are there any pending changes?

Chinese Characters: Does the file path or content contain Chinese characters? There are currently some known bugs in how OpenCode Server handles Chinese. Although we've implemented several workarounds, there might still be edge cases.

Looking forward to your reply!

[140270103901]

@LaiZhou thank you for the detailed troubleshooting steps!

I managed to identify the root cause and fix the issue, and I'd like to share my findings.

1. The Root Cause: Windows Path Incompatibility The issue stems from the path format. The plugin sends paths with forward slashes (e.g., D:/Project), but the OpenCode Server (v1.1.25) on Windows strictly expects backslashes (e.g., D:\Project). This caused the API calls to return empty results, preventing the diff view from triggering.

2. How I Fixed It (Context & Disclaimer) I want to be transparent: I am not proficient in Kotlin. All the debugging analysis and the subsequent code fixes were generated by OpenCode itself based on the logs and behavior I observed.

OpenCode suggested adding a normalizeDirectory() method in OpenCodeApiClient.kt to convert / to \ before making requests. After applying this AI-generated fix and rebuilding, the Diff View now pops up automatically as expected!

3. Request for Review Since this solution was entirely AI-generated and I lack the expertise to evaluate Kotlin code quality, could you please review the fix for potential side effects or edge cases? I want to ensure it aligns with your project standards before you consider merging similar logic.

Thanks again for your support!

Additional Context(The summary generated by opencode):

Summary of Our Conversation

Project Context

We are debugging and testing the OpenCode JetBrains Plugin - a plugin for JetBrains IDEs (IntelliJ IDEA, PyCharm, etc.) that integrates OpenCode AI coding assistant.

The Problem

The Diff View functionality is not working:

• When OpenCode AI modifies files, the diff window should automatically pop up in the IDE
• But it doesn't appear despite OpenCode completing the modification successfully

Root Cause Identified

The issue is path format incompatibility:

• The plugin sends paths with forward slashes: D:/GithubClone/OpenCode_UI-main
• OpenCode server expects backslashes: D:\GithubClone\OpenCode_UI-main

This causes API calls like /session?directory=D:/GithubClone/OpenCode_UI-main to return empty arrays, breaking the polling fallback mechanism.

Files Modified

1. src/main/kotlin/ai/opencode/ide/jetbrains/OpenCodeService.kt

   • Added pollForDiffs() method - polls for busy sessions and fetches diffs
   • Added scheduleDiffPolling() method - schedules polling every 5 seconds
   • Modified tryConnect() to call pollForDiffs() immediately
   • Modified connectToSse() to call scheduleDiffPolling() on connection
   • Added diffPollingTask field and cleanup in disconnectAndReset()

2. src/main/kotlin/ai/opencode/ide/jetbrains/api/OpenCodeApiClient.kt

   • Modified findBusySession() to use /session endpoint directly (fallback when /session/status fails)
   • Added normalizeDirectory() method to convert forward slashes to backslashes
   • Applied path normalization to getSessions(), getSessionStatuses(), and getSessionDiff()

Current Status

• Root cause found: Path format issue (forward slash vs backslash)
• Fix implemented: Added normalizeDirectory() method
• Pending: Need to rebuild and test the plugin

Test Results from User

• OpenCode server correctly publishes session.diff and session.idle events (confirmed from OpenCode logs)
• SSE connection is established
• /session?directory=D:/GithubClone/OpenCode_UI-main returns empty (path format issue)
• /session?directory=D:\GithubClone\OpenCode_UI-main returns 4 sessions (correct!)
• /session/{id}/diff API returns diff data correctly

Files to Include in Future Context

D:\GithubClone\OpenCode_UI-main\src\main\kotlin\ai\opencode\ide\jetbrains\OpenCodeService.kt
D:\GithubClone\OpenCode_UI-main\src\main\kotlin\ai\opencode\ide\jetbrains\api\OpenCodeApiClient.kt

Next Steps

1. User needs to run ./gradlew.bat build to rebuild the plugin
2. User needs to reinstall the plugin in PyCharm
3. User needs to restart PyCharm completely
4. Test the diff view functionality again

Key Technical Details

• OpenCode Desktop Version: 1.1.25 (downloaded from official website)
• API Port: 4096
• SSE Events: session.diff, session.idle are published by server but not received by plugin (possible separate issue)
• Polling Fallback: Implemented to work around SSE event issues
• Path Normalization: Server expects Windows-style backslashes in directory parameter

---

Detailed Prompt for Continuing

We are debugging the OpenCode JetBrains Plugin's Diff View functionality. The issue is that when OpenCode AI modifies files, the diff window doesn't automatically appear in the IDE.

**Root Cause Found**: Path format incompatibility. The plugin sends paths with forward slashes (e.g., `D:/GithubClone/OpenCode_UI-main`) but the OpenCode server (version 1.1.25) expects backslashes (e.g., `D:\GithubClone\OpenCode_UI-main`).

**Files Modified**:
1. `src/main/kotlin/ai/opencode/ide/jetbrains/OpenCodeService.kt`:
   - Added `pollForDiffs()` method to poll for busy sessions and fetch diffs
   - Added `scheduleDiffPolling()` method to schedule polling every 5 seconds
   - Modified `tryConnect()` to call `pollForDiffs()`
   - Modified `connectToSse()` onConnected callback to call `scheduleDiffPolling()`

2. `src/main/kotlin/ai/opencode/ide/jetbrains/api/OpenCodeApiClient.kt`:
   - Added `normalizeDirectory()` method to convert forward slashes to backslashes
   - Applied normalization to `getSessions()`, `getSessionStatuses()`, and `getSessionDiff()`
   - Modified `findBusySession()` to use `/session` endpoint directly as fallback

**Test Results**:
- `/session?directory=D:/GithubClone/OpenCode_UI-main` → returns empty array
- `/session?directory=D:\GithubClone\OpenCode_UI-main` → returns 4 sessions (correct!)
- `/session/{id}/diff` → returns correct diff data

**Next Steps**:
1. Rebuild the plugin: `./gradlew.bat build`
2. Reinstall in PyCharm: Settings → Plugins → ⚙ → Install Plugin from Disk
3. Restart PyCharm completely
4. Test by connecting to OpenCode (127.0.0.1:4096), making a file modification, and waiting 5-10 seconds for the diff window

Please continue debugging and testing the plugin.

[LaiZhou]

@140270103901

Thank you for your feedback! Since this is a personal project and I don’t have access to a Windows environment, I haven't had the chance to test it on that platform yet. I will look into this and work on a fix.

Additionally, I’d like to clarify that all the code for this project was written using OpenCode.

If possible, could you please help me test the new version 1.0.4 on Windows? I would appreciate knowing if it resolves the issues you encountered.

OpenCode_UI-1.0.4.zip

[140270103901]

@LaiZhou I tested the latest version 1.0.4 on Windows. Unfortunately, the issue persisted, so I dug deeper into the codebase.

I have successfully fixed it and verified the solution.

The Core Issue: It wasn't just the API calls; the SSE (Server-Sent Events) subscription was failing. The OpenCode Client on Windows performs strict string matching on the directory parameter.

• The plugin was sending: D:/Project (Forward slashes, standard IntelliJ behavior)

• The server expected: D:\Project (Backslashes) Because of this mismatch, the server never delivered session.diff events to the plugin.

The Fix Implemented:

Path Normalization: I used opencode to creat a toOpenCodeServerPath() helper in PathUtil.kt. It detects the OS and ensures Windows paths use \ while macOS/Linux paths use /.

################################################################################################

While testing on Windows, I also wanted to bring up a point regarding the Accept/Reject logic. Please note that this might be a matter of personal preference, but I wanted to share my findings.

The Logic Fix: "Reject" Workflow

• Issue: The "Reject" action was reverting files to the session start (State A) instead of the most recent accepted state (State B).

  • Scenario: Accept A→B. Then OpenCode suggests B→C. Clicking "Reject" causes the file to revert to A (loss of work).

• Root Cause: The SessionManager was overwriting the local baseline with the Server's "before" content (which is always session-start) on every new diff.

Solution: I modified SessionManager.kt to:

1. Update baselineSnapshot to the current disk content immediately upon Accept.

2. Prevent onDiffReceived from overwriting an existing baseline.

3. Force resolveBeforeContent to prioritize the local baseline.

I’m sharing the detailed analysis and the code snippets in the attachment purely as a reference to help you locate the issue. Hope this saves you some time, Thanks again for building this!

Windows_SSE_Fix_Report.md

Fix_Reject_Logic_Report.md

[LaiZhou]

@140270103901

OpenCode_UI-1.0.4.zip

This issue has been resolved. I have re-reviewed and improved the diff strategy. Please try the latest version v1.0.4. Thanks for your feedback!

1.0.4

• Session Auto-Resume: New terminals now automatically load the most recent session history.
• Task Notification: Added system notification when AI completes a task (Busy -> Idle).
• Stability: Fixed issue where moving the terminal tab caused disconnection.
• Diff View: Accept now writes AI output before staging, Reject restores the AI baseline, and Local History is used as fallback.
• Diff Alerts: Shows a Local Modified label when disk content differs from AI output.
• Input: Improved prompt injection reliability using TUI API.
• Links: Added support for clickable file links (@file#Lx-y) in terminal.
• Windows Paths: Fixed path separator handling so the Diff panel opens correctly.
• Auth: Connection dialog now supports optional OpenCode server password.
• Port Detection: Improved logic to avoid suggesting ports that are already in use.
• Terminal Tabs: Terminal tab names now include the port (OpenCode(4096)).

[140270103901]

@LaiZhou Thank you so much for your patience and for walking me through this! The solution works perfectly now. I really appreciate the time you took to help me resolve this issue. I'll go ahead and close this issue now.