coilyco-flight-deck/agentic-os
1
0
Fork 0
Code Issues 33 Pull requests Projects Releases Packages Wiki Activity Actions

Wire Warp config symlinks on Windows (Mac-only setup story misses %LOCALAPPDATA%) #11

New issue
Open
opened 2026-05-23 20:53:19 +00:00 by coilysiren · 0 comments
coilysiren commented 2026-05-23 20:53:19 +00:00
Owner
Copy link

Originally filed by @coilysiren on 2026-05-20T05:11:27Z - https://github.com/coilysiren/agentic-os/issues/99

Problem

On Windows, Warp reads its config from %LOCALAPPDATA%\warp\Warp\config\ (Git Bash form: /c/Users/$USER/AppData/Local/warp/Warp/config/), not ~/.warp/. The setup story in README.md and docs/FEATURES.md only documents the Mac path (ln -sf "$PWD/warp/settings.toml" ~/.warp/settings.toml), so the symlinks never get created on Windows boxes unless done by hand. agentic-os-kai/setup.sh only walks skill dirs, not the Warp config tree, so it does not fill the gap either.

Symptom

Caught on my personal Windows machine. settings.toml at the Windows Warp config dir was a regular 3596-byte file (canonical is 5600 bytes), and tab_configs/ + themes/ subdirs did not exist at the Windows target at all. UI features driven by canonical settings (vertical tabs, block-mode behavior, sombra theme, redaction regex list) were silently running on stale defaults.

Fixed by hand this session - backed up settings.toml to settings.toml.bak.20260519-220900 and symlinked all three files:

/c/Users/firem/AppData/Local/warp/Warp/config/settings.toml -> /x/projects-x/coilysiren/agentic-os/warp/settings.toml
/c/Users/firem/AppData/Local/warp/Warp/config/tab_configs/startup_config.toml -> /x/projects-x/coilysiren/agentic-os/warp/tab_configs/startup_config.toml
/c/Users/firem/AppData/Local/warp/Warp/config/themes/coilysiren-sombra-wallpaper.yaml -> /x/projects-x/coilysiren/agentic-os/warp/themes/coilysiren-sombra-wallpaper.yaml

Proposal

Teach the setup story (and ideally a script) about the Windows Warp path. Either extend agentic-os-kai/setup.sh or add agentic-os/scripts/wire-warp.sh that:

  1. Detects OS and chooses the right Warp config dir: ~/.warp/ on macOS, $LOCALAPPDATA/warp/Warp/config/ on Windows (use MSYS=winsymlinks:nativestrict for native symlinks; Developer Mode required, same as the existing skills sweep). Linux Warp path TBD.
  2. Symlinks the three current files. Creates parent dirs as needed.
  3. Backs up any existing non-symlink target before replacing it.
  4. Updates README.md, docs/FEATURES.md, and tooling-warp SKILL.md to show both OS paths instead of claiming ~/.warp/ is universal.
_Originally filed by @coilysiren on 2026-05-20T05:11:27Z - [https://github.com/coilysiren/agentic-os/issues/99](https://github.com/coilysiren/agentic-os/issues/99)_ **Problem** On Windows, Warp reads its config from `%LOCALAPPDATA%\warp\Warp\config\` (Git Bash form: `/c/Users/$USER/AppData/Local/warp/Warp/config/`), not `~/.warp/`. The setup story in `README.md` and `docs/FEATURES.md` only documents the Mac path (`ln -sf "$PWD/warp/settings.toml" ~/.warp/settings.toml`), so the symlinks never get created on Windows boxes unless done by hand. `agentic-os-kai/setup.sh` only walks skill dirs, not the Warp config tree, so it does not fill the gap either. **Symptom** Caught on my personal Windows machine. `settings.toml` at the Windows Warp config dir was a regular 3596-byte file (canonical is 5600 bytes), and `tab_configs/` + `themes/` subdirs did not exist at the Windows target at all. UI features driven by canonical settings (vertical tabs, block-mode behavior, sombra theme, redaction regex list) were silently running on stale defaults. Fixed by hand this session - backed up `settings.toml` to `settings.toml.bak.20260519-220900` and symlinked all three files: ``` /c/Users/firem/AppData/Local/warp/Warp/config/settings.toml -> /x/projects-x/coilysiren/agentic-os/warp/settings.toml /c/Users/firem/AppData/Local/warp/Warp/config/tab_configs/startup_config.toml -> /x/projects-x/coilysiren/agentic-os/warp/tab_configs/startup_config.toml /c/Users/firem/AppData/Local/warp/Warp/config/themes/coilysiren-sombra-wallpaper.yaml -> /x/projects-x/coilysiren/agentic-os/warp/themes/coilysiren-sombra-wallpaper.yaml ``` **Proposal** Teach the setup story (and ideally a script) about the Windows Warp path. Either extend `agentic-os-kai/setup.sh` or add `agentic-os/scripts/wire-warp.sh` that: 1. Detects OS and chooses the right Warp config dir: `~/.warp/` on macOS, `$LOCALAPPDATA/warp/Warp/config/` on Windows (use `MSYS=winsymlinks:nativestrict` for native symlinks; Developer Mode required, same as the existing skills sweep). Linux Warp path TBD. 2. Symlinks the three current files. Creates parent dirs as needed. 3. Backs up any existing non-symlink target before replacing it. 4. Updates `README.md`, `docs/FEATURES.md`, and `tooling-warp` SKILL.md to show both OS paths instead of claiming `~/.warp/` is universal.
coilysiren added
P4
 and removed
P3
 labels 2026-05-31 07:00:07 +00:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
docs-o2r-command-delivery-qwen-storage
v0.11.1
v0.11.0
v0.10.0
v0.9.0
v0.8.0
v0.7.0
v0.6.0
v0.5.0
v0.4.0
v0.3.0
v0.2.12
v0.2.11
v0.2.10
v0.2.9
v0.2.8
v0.2.7
v0.2.6
v0.2.5
v0.2.4
v0.2.3
v0.2.2
v0.2.1
v0.2.0
v0.1.0
Labels
Clear labels
  
P0
now / blocking / urgent

  
P1
next / important

  
P2
backlog / will do

  
P3
someday / low

  
P4
icebox / frozen / reopen if it becomes real

No labels
P0
P1
P2
P3
P4
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
coilyco-flight-deck/agentic-os#11
No description provided.