Remote backend: adding workspaces uses local filesystem and rejects remote paths
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 48/100
- Issue type
- Bug
- Clarity
- Mostly clear
- Activity status
- Quiet
- Tech stack
- typescript
- Domain
- backend-api-design, desktop
Research direction
Start by tracing the desktop UI workspace-add flow and the remote API/CLI workspace path used by the daemon. Compare local path validation with remote-mode behavior, then verify that a remote workspace can be added without client-side rejection using the Windows-to-WSL and macOS-to-Linux reproductions.
Written by the indexing model from the issue text.
Description
Summary
When Backend mode = Remote, adding a workspace from the desktop client still validates paths against the client filesystem instead of the remote daemon filesystem.
This makes it impossible to add workspaces in common server/client setups such as:
- Windows UI -> WSL remote daemon
- macOS UI -> remote Linux daemon
The UI shows errors like:
Added 0 workspaces. Skipped 1 invalid path (not a folder).
Expected behavior
When using a remote backend, adding a workspace should be remote-aware:
- either browse/select paths from the remote machine's filesystem, or
- accept/normalize remote path formats such as WSL paths and forward them to the daemon for validation.
Actual behavior
The desktop client opens the local folder picker and validates against the local machine.
That means:
- Windows client can browse into WSL from Explorer and select a folder, but the selected WSL/Linux server folder is still rejected by the UI as invalid in remote mode
- macOS client cannot add Linux server folders from the UI
- even when the remote daemon connection is healthy, workspace creation fails with
invalid path (not a folder)
Reproduction
Windows -> WSL remote daemon
- Run CodexMonitor daemon in WSL/Linux.
- Connect CodexMonitor on Windows with
Backend mode = Remote. - Try to add a workspace that exists on the WSL/Linux side, including one selected through Explorer under
\\wsl\## Summary WhenBackend mode = Remote`, adding a workspace from the desktop client still validates paths against the client filesystem instead of the remote daemon filesystem.
This makes it impossible to add workspaces in common server/client setups such as:
- Windows UI -> WSL remote daemon
- macOS UI -> remote Linux daemon
The UI shows errors like:
Added 0 workspaces. Skipped 1 invalid path (not a folder).
Expected behavior
When using a remote backend, adding a workspace should be remote-aware:
- either browse/select paths from the remote machine's filesystem, or
- accept/normalize remote path formats such as WSL paths and forward them to the daemon for validation.
Actual behavior
The desktop client opens the local folder picker and validates against the local machine.
That means:
- Windows client can browse into WSL from Explorer and select a folder, but the selected WSL/Linux server folder is still rejected by the UI as invalid in remote mode
- macOS client cannot add Linux server folders from the UI
- even when the remote daemon connection is healthy, workspace creation fails with
invalid path (not a folder)
Reproduction
Windows -> WSL remote daemon
- Run CodexMonitor daemon in WSL/Linux.
- Connect CodexMonitor on Windows with
Backend mode = Remote.
or\\wsl\.localhost. - Observe:
- Windows can browse into WSL folders via Explorer
- the selected WSL folder is still rejected by the UI in remote mode
- error similar to
Added 0 workspaces. Skipped 1 invalid path (not a folder).
macOS -> Linux remote daemon
- Run CodexMonitor daemon on a Linux machine.
- Connect CodexMonitor on macOS with
Backend mode = Remote. - Try to add a workspace from the desktop UI.
- Observe that the local macOS picker is used and remote Linux paths cannot be added.
Prior context
This remote behavior was introduced in #54, but multiple users are still hitting this exact workspace-add problem and no clear workaround has been provided.
Relevant reports in #54 comments include:
- WSL/Windows users reporting path errors and inability to add workspaces from the UI
- macOS user reporting that remote mode still opens the local macOS folder picker
Why this matters
Remote backend mode is working enough to connect and run against the server, but without a remote-aware workspace-add flow it is effectively incomplete for real WSL/Linux remote usage.
Possible solutions
- Add a remote filesystem browser / remote folder picker when
Backend mode = Remote. - Add explicit support for WSL and other remote path formats, and let the daemon validate them.
- In remote mode, avoid client-side
is this a local folder?checks and delegate validation to the daemon. - Provide a documented fallback/workaround if full remote browsing is not ready yet.
Temporary workaround
The only known workaround today is to add the workspace directly on the daemon side via remote API / CLI rather than through the desktop UI.
That is not discoverable and is not documented as an official workflow.
- Dominant language
- TypeScript
- Stars
- 4.3k
- Forks
- 416
- PR merge metrics
- No merged PRs in 30d
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from Dimillian/CodexMonitor
-
Difficulty 1/5 Under an hour Newbie friendliness 78/100
Dimillian/CodexMonitor#590 ·
-
Difficulty 3/5 1-2 days Newbie friendliness 63/100
Dimillian/CodexMonitor#615 ·
-
Codex Monitor does not surface MCP browser tool approval prompts, making browser tools appear hung Open
Difficulty 4/5 3-5 days Newbie friendliness 52/100
Dimillian/CodexMonitor#612 ·
-
Difficulty 4/5 3-5 days Newbie friendliness 55/100
Dimillian/CodexMonitor#602 · 1 comment · 1 reaction ·
-
Difficulty 4/5 3-5 days Newbie friendliness 38/100
Dimillian/CodexMonitor#599 ·
All issues in Dimillian/CodexMonitor
Similar issues
-
blocklist removal
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
MetaMask/eth-phishing-detect#296544 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
pastelsky/bundlephobia#1122 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
-
category/development priority/P2 scope/file-operations scope/testing type/enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
-
Enatega Customer and Rider app: Add-ons price is not visible to customer after order is placed. Open
Difficulty 2/5 1-3 hours Newbie friendliness 75/100