Quick Start

This page is for users who 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.

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. Build sandbox image

manyoyo build --iv 1.8.0-common

4. Migrate existing configs now

manyoyo init all

5. Start agents directly

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

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