beads/docs/getting-started
Bùi Phan Viết Cường aa8cc065f4
docs(troubleshooting): document the two native-Windows integration traps (#5838)
* docs(troubleshooting): document the two native-Windows integration traps

bd.exe is a native Windows binary, and two consequences of that are
undocumented. Both cost real debugging time because neither fails loudly.

- npm installs bd as a generated bd.cmd shim, so Node's execFile/spawn --
  which run their target directly, without a shell -- never resolve it and
  die with "spawn bd ENOENT" while bd works in the same terminal.
- Git Bash resolves /tmp to its own temp directory; bd, being native,
  resolves it against the current drive root. `bd export -o /tmp/x.jsonl`
  reports success and writes C:\tmp\x.jsonl.

Adds a subsection for each under Platform-Specific Issues, following the
symptom/solution shape already used there, plus cross-links from the FAQ
Windows entry and the installation Windows notes.

Agent-Signature: claude-code-claude-opus-5[1m]-unknown-reasoning on behalf of CuongBPV

* Update troubleshooting for Windows `/tmp` path issues

Clarify behavior of `/tmp` paths in Git Bash and provide solutions for Windows path handling.

* Update FAQ for Windows integration details

Clarify integration details regarding `bd.exe` and `/tmp` paths in Windows.

---------

Co-authored-by: CuongBPV <cuongbpv@fpt.com>
2026-08-20 05:41:39 -07:00
..
ide-setup.md [codex] Add Kiro setup recipe (#4535) 2026-07-27 22:28:43 -07:00
installation.md docs(troubleshooting): document the two native-Windows integration traps (#5838) 2026-08-20 05:41:39 -07:00
quickstart.md docs: caveat --parent label inheritance with size/effort labels (#4562) (#5123) 2026-07-31 01:44:50 -07:00
sync-setup.md /{.github,docs,engdocs,go,internal,scripts}: bump dolt 2026-07-15 13:14:34 -07:00
upgrading.md Guard and qualify historical upgrades to v1.2 (#4907) 2026-08-06 18:45:04 -07:00