Skip to content

Commit e0865e0

Browse files
committed
docs: add fork Windows build notes
1 parent d6a73d6 commit e0865e0

File tree

2 files changed

+44
-0
lines changed

2 files changed

+44
-0
lines changed

AGENTS.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,10 @@
22

33
- To test opencode in the `packages/opencode` directory you can run `bun dev`
44

5+
## Fork Notes
6+
7+
- Windows build notes for the EntityProcess fork: [fork/AGENTS.md](fork/AGENTS.md)
8+
59
## Tool Calling
610

711
- ALWAYS USE PARALLEL TOOLS WHEN APPLICABLE. Here is an example illustrating how to execute 3 parallel file reads in this chat environment:

fork/AGENTS.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
# Fork Notes (EntityProcess)
2+
3+
This document is fork-specific and is referenced by the root `AGENTS.md`.
4+
5+
## Windows Build (CLI)
6+
7+
### Requirements
8+
9+
- Bun 1.3+
10+
- PowerShell (recommended)
11+
12+
### Build the CLI (Windows only)
13+
14+
From the repo root:
15+
16+
```powershell
17+
# Stop any running opencode.exe (Windows locks the file)
18+
Get-Process opencode -ErrorAction SilentlyContinue | Stop-Process -Force
19+
20+
# Clean previous outputs
21+
Remove-Item -Recurse -Force -ErrorAction SilentlyContinue packages\opencode\dist
22+
23+
# Build current platform only
24+
bun run --cwd packages/opencode script/build.ts --single --skip-install
25+
```
26+
27+
Expected output binary:
28+
29+
- `packages/opencode/dist/opencode-windows-x64/bin/opencode.exe`
30+
31+
### Running
32+
33+
```powershell
34+
.\packages\opencode\dist\opencode-windows-x64\bin\opencode.exe --version
35+
```
36+
37+
### Notes (Windows quirks)
38+
39+
- If `rm -rf dist` fails inside the build script, it’s usually because `opencode.exe` is still running. Stop it first (see above).
40+
- If TypeScript typecheck fails in `packages/desktop` or `packages/enterprise` on Windows, it can be due to symlink checkout differences. In this fork, the `playground` branch includes a workaround for `custom-elements.d.ts` when symlinks are not available.

0 commit comments

Comments
 (0)