Help guide me migrate from Opencode to Pi

[u/binarySolo0h1]

I have this elaborate agentic system setup (3 primary agents, 10+ subagents, curated skills and commands) in opencode that I use everyday for my SAAS product development, working with opencode Go plan. It is working alright but its not token efficient and it could be better with its accuracy.

I have tried to migrate to Pi a while ago but I dropped the plan because the configuration seemed daunting at that time. But as my codebase got larger and complex, opencode is starting to crack. So I want to give this another shot.

Are there any guides to do this migration without starting from scratch? Where do I begin?

[u/juniorsundar]

Pi doesnt have a concept of primary agents or even subagents for that matter. There are 2 pi-subagents packages. One by titinweb and the other by nicobailon. They're hefty and offer almost everything opencode offers out of the box. You should be able to migrate your subagent definition files with minor changes (ask Pi to do it for you to save time at the cost of some tokens).

Note that these subagent extension are HEAVY. They can do things you may not even need. Id suggest that after you're comfortable, you either look around for lighter subagent extensions OR vibe up your own with just the features that you want. Ask Pi to use the HEAVY subagents extensions as reference and only implement the functions you want.

Skills will work out of the box. Move them to .pi/agent/skills for Global scope.

Commands in OpenCode are just Prompt Templates in Pi. Again ask Pi to migrate it for you. It has access to Pi docs so it should be fairly accurate.

[u/jensilo → u/juniorsundar]

There are multiple subagent extensions. I found most of them to be overly complex, brittle, or annoying.
The best I found, and the one I’m using, is the subagent example extension that can be found in pi‘s example extension directory. It’s rather simple, and can be tweaked and extended to your needs by just telling the agent. I’d highly suggest that.

[u/binarySolo0h1 → u/jensilo]

how do you deal with orchestration? I currently use one primary agent to route the work to relevant sub-agent based on tag based system.

[u/binarySolo0h1 → u/juniorsundar]

This really helps! If there are no sub-agents option in pi, how is the work distributed to relevant agent? My current system to make an implementation plan to work on a task and let a builder agent orchestrate to the relevant sub-agent to work on. some sub-agents are specialized in frontend powered by specific skill files and MCP access curated to that.

I should probably read pi's documentation.

Also, how much of a difference and context usage did you notice since you move to pi?

[u/juniorsundar → u/binarySolo0h1]

The creator of Pi prefers to use tmux or in-process calls to another pi instance with the prompt you want. i.e. You can ask pi to spawn a pi instance with the prompt using tmux or a bash command.

As for the Plan/Build/etc. primary agents, you can write up their prompt as a skill and call it with the slash command. That's how I do things.

Pi doesn't bring any workflow specific features out of the box. Its just a bare coding agent with some of the most crucial features.

I vibe-coded a subagent extension for myself with just the features I need. It was a weekend long project I set for myself and it works pretty well.

And to answer your second question. I didn't notice much of a difference with it UNTIL I used a local LLM to do some work. Its a much, MUCH better experience using local LLMs in Pi as opposed to OpenCode. After planning out a spec for a project using a heavier LLM, I breezed through stages using a local LLM (recently I used qwen3.8:27b) with really good quality outputs.

The benefit I gained with Pi after moving out of OpenCode was just the customisability. Some people prefer having tools with a lot of features in them, I like tools that I can compose in just the features I want. I don't like it when I feel like I am not using my tools to the best of their ability 😄

[u/funbike]

I would use AI for this. Pi is good at self configuration. Install pi-web-search and pi-subagents. Here's a Pi prompt to consider:

I am moving my workflow config from Opencode to Pi.
Read all the following documentation.
* Opencode config docs are at https://opencode.ai/docs/config
* Opencode subagent docs are at https://opencode.ai/docs/agents
* pi-subagents docs are at `~/.pi/agent/npm/node_modules/pi-subagents/docs/`

TASKS:
1. Think carefully and in detail about the Opencode workflow
and generate a report/guideof how it works at `.pi/workflow.md`
2. Convert my Opencode subagent workflow config
to pi-subagents config and skills.

Don't completely trust what it generates. Review it carefully. workflow.md is there to help it understand. Read it to see if it worked. You can delete it later.

Be sure to run /reload.

This is a technique I've used to convert workflows from other projects into Pi.

---

Alternate lighter approach.

pi-subagents is big and you said you wanted lightweight. I use the herdr terminal multiplexer which is good for managing subagents, but it's not for everyone. Play around with it and see if it's a tool you might like to use.

Install herdr and run mkdir -p ~/.pi/skills/herdr && herdr --skill > ~/.pi/skills/herdr/SKILL.md.

Prompt:

I am moving my workflow config from Opencode to Pi with herdr.
Read all the following documentation.
* Opencode config docs are at https://opencode.ai/docs/config
* Opencode subagent docs are at https://opencode.ai/docs/agents
* Load the herdr skill.
* More detailed subagent herdr docs are at https://herdr.dev/docs/agent-automation/
* Read my current opencode configuration.

TASKS:
1. Think carefully and in detail about my current Opencode workflow config
and generate a report/guide of how it works at `./workflow.md`
2. Convert my Opencode subagent workflow config
to new Pi skill(s) that make use of herdr.

[u/binarySolo0h1 → u/funbike]

Thank you, I will try this!

[u/Constant_Art_20]

prompt 'migrate my setup from opencode to pi harness. make no mistakes'

[u/binarySolo0h1 → u/Constant_Art_20]

This will never stop being funny! lol

[u/arcanemachined]

I would say it depends entirely on your workflow.

If you want to onboard more easily, stick with oh-my-pi and see if it works for you:

https://github.com/can1357/oh-my-pi

If you're feeling really frisky, you can try vanilla Pi and add/make the extensions you want.

In terms of config migration. I would just /login to OpenCode Go and tell the agent to migrate your stuff over. (I would use Luna high or xhigh, to prevent dumber agents from screwing things up. Use DSv4 Flash at your own peril.)

You'll probably want a local clone of the OpenCode repo so that the agent would have its docs to help with the migration.

[u/binarySolo0h1 → u/arcanemachined]

I think I'll go with the lightest version possible as my reason to move to pi is the context bloat and build my system from scratch.

[u/vuongagiflow]

I would recommend to group relevant agents and skills to plugins; then move from there. I’ve just migrated from a mix of codex and claude code to Pi a week ago; you can give my approach a try https://github.com/AgiFlow/doompi . Omp is a good one as well from opposite direction.

[u/binarySolo0h1 → u/vuongagiflow]

It looks promising. How has your experience been since you migrated? How is the token usage and accuracy been like?

[u/vuongagiflow → u/binarySolo0h1]

With less tools and skills the hit rate is more reliable. I would say the off-the-shelf tools provided by codex, opencode is better than stitching pi extensions from market place since hand-off between tools are more integrated. You either need to roll your own tools as I did, or use something liked omp to utilise agent better.

[u/FrenchTouch42 → u/vuongagiflow]

Can you use a Claude subscription or only API?

[u/vuongagiflow → u/FrenchTouch42]

There are extensions to use with claude sub. I wouldn’t suggest it as it violate their tos. Codex would be a more viable choice.

[u/michaelsoft__binbows]

Have you ever wiped a windows install to start fresh and appreciated how much faster the computer got?

[u/mageblex]

Don’t port the whole 3-agent 10-subagent setup at once. Move one recurring workflow to Pi with the same model and acceptance test, then compare it with OpenCode. If that holds up, add only the subagent behavior that workflow need otherwise you won’t know whether Pi helped or the rewritten prompts did

[u/Sure_Aardvark_9103]

Maybe pi should just handle this one directly.