github / github/copilot-cli

Question: ReFS / Dev Drive local-sandbox limitation on Windows - is it known, and could it be documented?

未關閉
#3,712 2 則留言 4 個 reaction 已指派 0 人 在 GitHub 檢視
area:permissions area:platform-windows
主要語言
Shell
星號
11.2k
分支
1.9k
平均合併
14 小時 16 分鐘
30 天內合併 PR
6

描述

### Summary

First off, thanks for the work on the local sandbox — it's a great feature. 🙏

This is a **friendly question / documentation request**, not a bug report, and
I fully understand the root cause may well sit on the **Windows platform side**
rather than in Copilot CLI itself.

When the local sandbox is enabled on Windows and the sandbox policy references
paths on a **ReFS volume (Dev Drive)**, sandboxed shell commands stop with a
`backend_error`. The runtime returns a very clear, helpful message — which
suggests the team is already aware of this and is handling it gracefully:

```
{"error":{"code":"backend_error","message":"The sandbox policy references paths
on ReFS volume(s) (D:) which may be a Dev Drive. The Bind Filter (BFS) used to
enforce filesystem policy does not work correctly on ReFS volumes, so sandboxed
processes may not be able to access files on those paths. Move your working
directory to an NTFS volume, or remove those paths from
readonlyPaths/readwritePaths."}}
```

(The message already mentions that the Windows **Bind Filter (BFS)** doesn't
work correctly on ReFS, so this looks like an underlying OS limitation that the
CLI is detecting and surfacing — which I appreciate.)

### What I'd like to confirm

1. **Is this a known limitation at the moment?** The clear error message makes
me think it is, but I wanted to confirm rather than assume.
2. If it's a current constraint, **would it be possible to mention it in the
docs** — e.g. in
[Configuring local sandbox settings](https://docs.github.com/en/copilot/how-tos/cloud-and-local-sandboxes/configuring-local-sandbox-settings)?
There's currently no mention of ReFS / Dev Drive / NTFS in the docs, and I
couldn't find an existing issue tracking it, so a short note would save
others some head-scratching.

### Why this matters (motivation, not a complaint)

On Windows, Microsoft Defender real-time scanning adds noticeable overhead to
small-file read/write operations. This is especially relevant for **Copilot CLI
specifically**: a large part of what the CLI does is **searching across files
and their contents** (grep/glob-style lookups, reading many small files to build
context), in addition to the usual dependency installs and builds. All of these
are small-file-I/O-heavy workloads where Defender overhead adds up quickly.

**Dev Drive (ReFS) is Microsoft's recommended solution** for exactly this kind
of workload (performance-mode antimalware on ReFS), so it's a particularly
attractive setup for running Copilot CLI. I'd like to keep my working directory
on a Dev Drive for that reason.

Because of the ReFS / Bind Filter interaction, though, the local sandbox and a
Dev Drive can't currently be used together on my setup. I completely understand
if this is gated by Windows platform behavior — I'm mainly hoping to (a) confirm
the current state and (b) have it documented so the trade-off is visible to
others. If it's something that could be supported down the line, that'd be a
nice bonus, but no pressure. 🙂

### Affected version

GitHub Copilot CLI 1.0.60.

### Environment

- Tool: GitHub Copilot CLI 1.0.60
- OS: Windows 11 Enterprise
- Volume: `D:` — FileSystemType **ReFS**, label `DevDrive`
- Sandbox: local sandbox enabled via `/sandbox enable`

### Steps to reproduce

1. On Windows 11, use a **Dev Drive** (ReFS), e.g. `D:`.
2. Place a working directory on that volume.
3. Start Copilot CLI there and run `/sandbox enable`.
4. Ask Copilot to run any shell command (e.g. `ls`).
5. The command stops with the `backend_error` shown above.

貢獻指南

開啟貢獻指南

研究方向

Start with the linked Configuring local sandbox settings page and review the reported backend_error for the ReFS/Dev Drive limitation. Confirm the current behavior and add a concise note covering ReFS, Dev Drive, NTFS, and the available workaround; the documentation should make the sandbox constraint clear to Windows users.

由索引模型根據 Issue 內容生成。

評估

技術堆疊
shell
領域
cli, documentation, operating-systems
Issue 類型
文件
難度
2/5
預估耗時
1-3 小時
活躍度
冷清
描述清晰度
基本清楚
新手友好度
55/100

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。