Suggestion: Clarify symlink workflow for existing OpenCode users

[Gerkinfeltser]

Hey, thanks again for porting PAI to OpenCode!

I got a bit confused during installation, but after digging through the docs I think I understand the intended workflow now. Might be worth making it clearer for others.

The confusion

The Quick Start shows:

git clone ...
bun run .opencode/PAIOpenCodeWizard.ts
opencode

This creates everything in the project directory. For someone with an existing OpenCode setup, it's not obvious how to integrate PAI with their global config.

The answer (buried in Manual Installation)

Step 4 of INSTALL.md has the key bit:

ln -s $(pwd)/.opencode ~/.opencode

This is actually a great approach — keeps ~ clean, config lives in a repo you control, upgrades are just git pull. But it's easy to miss if you follow the Quick Start.

Suggestion

For existing OpenCode users, the symlink step is the important part. A few options:

1. Add a note to Quick Start — "Already using OpenCode? See the symlink setup in Manual Installation Step 4"
2. Wizard option — Ask "Create symlink to ~/.opencode?" during setup
3. Separate section — "Adding PAI to an existing OpenCode installation"

The original PAI uses cp -r .claude ~/, but honestly the symlink approach is better for maintenance. Just needs a bit more visibility in the docs.

Thanks again!

[Steffen025]

Hey @Gerkinfeltser, thanks for the great feedback! You're absolutely right — the symlink step was buried and easy to miss.

Fixed in v1.2.1 (just pushed):

1. Added "Existing OpenCode Users" section to INSTALL.md with clear symlink instructions, backup/restore steps, and explanation of why symlinks > copying
2. Added a note in Quick Start (README.md) pointing existing users to the symlink setup
3. The wizard now also does more heavy lifting with provider configuration (new profile system)

The symlink approach is indeed the intended workflow — config lives in a repo you control, upgrades are git pull, rollback is switching the symlink back. Glad you figured it out and took the time to suggest making it clearer for others.

Commit: d098155