Migrate Existing Agent Configs

This page is for users who already have npm / Docker or Podman set up and a working agent on the host (new to MANYOYO? start with Install). You already:

• can run claude / codex / gemini / opencode on host
• already have model access configured (env vars or local auth)

Goal: migrate that working setup into MANYOYO with minimal steps.

The default image is the prebuilt ghcr.io/xcanwin/manyoyo, pulled automatically when missing locally, so you do not need manyoyo build; build only when you want a custom image.

1. Install manyoyo

npm install -g @xcanwin/manyoyo
manyoyo -v

2. Install Podman / Docker

Container runtime install/switch references:

• Install Podman (Recommended)
• Install Docker (Optional)

3. Migrate existing configs now

manyoyo init all

4. Start agents directly

manyoyo run -r claude
manyoyo run -r codex
manyoyo run -r gemini
manyoyo run -r opencode

If you want to verify the help output and config path first, run:

manyoyo --help
manyoyo run --help
manyoyo config show -r claude

Troubleshooting

If init reports missing variables, edit the related runs.<agent>.env in ~/.manyoyo/manyoyo.json:

vim ~/.manyoyo/manyoyo.json

# Example: inspect runs.claude.env
node -e "console.log(require('json5').parse(require('fs').readFileSync(process.env.HOME+'/.manyoyo/manyoyo.json','utf8')).runs?.claude?.env)"

More issues: Troubleshooting

Next Steps

• Basic Usage
• Configuration
• CLI Reference
• Troubleshooting