diff --git a/.gitignore b/.gitignore
index 1519562..d64f961 100644
--- a/.gitignore
+++ b/.gitignore
@@ -19,13 +19,14 @@
 !/plugins/
 !/.gitignore
 
-# Machine config for the UTF-8 shell fix (see https://www.xsinfo.vip/windows/01-opencode-utf8.html).
-# OpenCode reads opencode.json from this directory and invokes pwsh.cmd as the shell,
-# so both are needed to reproduce a working setup on another machine. Note the shell
-# path in opencode.json is absolute and per-user, so it must be edited per machine.
-!/opencode.json
+# UTF-8 shell launcher (see https://www.xsinfo.vip/windows/01-opencode-utf8.html).
+# Portable: it only calls chcp and pwsh.exe from PATH, so it is safe to share.
 !/pwsh.cmd
 
+# opencode.json is intentionally NOT tracked: its "shell" field holds an absolute
+# per-user Windows path (C:\Users\<name>\...), which breaks OpenCode on Linux/macOS.
+# Each machine keeps its own opencode.json and points "shell" at its own pwsh.cmd.
+
 # npm manifest for the sqlite plugin's better-sqlite3 dependency; without it the
 # plugin fails to load with "Cannot find package 'better-sqlite3'".
 !/package.json
diff --git a/opencode.json b/opencode.json
deleted file mode 100644
index 2ea898a..0000000
--- a/opencode.json
+++ /dev/null
@@ -1,4 +0,0 @@
-{
-  "$schema": "https://opencode.ai/config.json",
-  "shell": "C:\\Users\\12500\\.config\\opencode\\pwsh.cmd"
-}
\ No newline at end of file