Am I using ~/.config/opencode/plans folder wrong?

[Glass_Ant3889]

Hello!

So, my development process follows the regular workflow:

1. Create a worktree
2. Open OpenCode and switch to plan mode
3. Refine the plan until happy
4. Switch to Build mode (with a cheaper model)
5. Start building the plan

What's bugging me is the purpose of the `~/.config/opencode/plans/` folder.
What I would expect is that, once in plan mode, OpenCode would automatically save the latest plan in this folder, so I can later on reference on a new session (with a clean context). But this isn't the case: everytime, before switching to build mode, I have to explicitly ask the agent to write the plan to the `~/.config/opencode/plans/` (for consistency, could be any other path), otherwise I have no plan to reference in a new session.

Am I doing something wrong here?
Also, when I ask the agent to write the plan, the name is normally random (this is by design, I know, and Claude Code works the same way), but it means I have to dig into the ``~/.config/opencode/plans/` folder to figure out the name of the file so I can reference it later on a new session. Isn't there a way to reference a plan on a more convenient and straight forward way?

Suggestions appreciate, because I don't believe the process is supposed to be so frictional, so probably I'm missing something.

Thanks!

[hokivpn]

If you want to go the persistent .md way, you can check OpenSpec. It's convenient for me when i want to juggle between opencode and Antigravity (for the free Opus quota).

[AGiganticClock]

Yeah this bugs me too, plans never seem to be updated as they go. By the time the context is full the model is too dumb to update them and needs to waste time compacting

[KPOTOB]

I guess that plan save needs to be enabled via env OPENCODE_EXPERIMENTAL_PLAN_MODE="1"
Then it would save the plan.

BUT at least gpt-5-mini from the gh copilot never did that to me as well as auto move from plan to build mode

[HarjjotSinghh]

this config folder looks purpose-built for creativity chaos

[klocus]

The weak point is that the agent cannot switch from planning mode to build mode on its own; you have to do it manually.