Claude Code → OpenCode Agent Migration Tool v1.0

A Python CLI utility that scans, previews, migrates, and synchronizes your custom agents between Claude Code and OpenCode — keeping both platforms in sync with a single command.

If you use both Claude Code and OpenCode, maintaining agents across both platforms manually is tedious and error-prone. AgentMigrator automates the entire process:

• Scans your Claude Code agents (global and project-level)
• Translates tools, models, permissions, and temperature settings to OpenCode format
• Previews changes with dry-run and diff modes before writing anything
• Migrates all agents or specific ones with automatic backups
• Syncs by detecting which agents are out of date between platforms

No external dependencies required — pure Python 3.

1. Download the script:

curl -o migrate_agents.py https://github.com/Arkessiah/agentsmigrator.git

2. Make it executable (optional):

chmod +x migrate_agents.py

3. Verify it works:

python migrate_agents.py --help

See what agents are available before doing anything:

python migrate_agents.py --scan

This lists all agents found in:

Output includes: name, scope, model, tools, and description for each agent.

Simulate the migration without writing any files:

python migrate_agents.py --dry-run --migrate

This shows exactly what would be created, including file paths and sizes.

See a side-by-side comparison of the original Claude Code format vs the converted OpenCode format:

python migrate_agents.py --diff <agent-name>

Example:

python migrate_agents.py --diff code-reviewer

Migrate all agents at once:

python migrate_agents.py --migrate

Or migrate a single agent by name:

python migrate_agents.py --migrate <agent-name>

Example:

python migrate_agents.py --migrate solidity-auditor

Backups are created automatically in ~/.agent-migration-backups/ whenever an existing file would be overwritten.

Check that both platforms are aligned:

python migrate_agents.py --sync

Output shows status per agent:

• ✓ Synchronized — system prompts match
• ⚠ Out of sync — prompts differ between platforms
• ✗ Only in Claude Code — not yet migrated

Flags can be combined:

python migrate_agents.py --dry-run --migrate --no-color
python migrate_agents.py --migrate --force

Claude Code uses a comma-separated list. OpenCode uses boolean flags with granular permissions.

Automatically assigned based on agent type keywords in the name/description:

When Bash is present in Claude Code tools, AgentMigrator generates safe default permissions:

permissions:
  bash:
    "git *": allow
    "npm *": allow
    "npx *": allow
    "python *": allow
    "pip *": allow
    "cargo *": allow
    "ls *": allow
    "cat *": allow
    "find *": allow
    "grep *": allow
    "*": ask

Tool references inside the system prompt are also translated:

~/.claude/agents/*.md          # Global agents
.claude/agents/*.md            # Project-level agents

~/.config/opencode/agent/*.md  # Global agents
.opencode/agent/*.md           # Project-level agents

~/.agent-migration-backups/    # Timestamped backups
~/.agent-migration.log         # Migration activity log

---
name: code-reviewer
description: Reviews code for quality and security
tools: Read, Grep, Glob, Bash
model: sonnet
---

You are a senior code reviewer...

---
description: Reviews code for quality and security
mode: subagent
model: anthropic/claude-sonnet-4-5-20250929
temperature: 0.2
tools:
  read: true
  grep: true
  glob: true
  bash: true
permissions:
  bash:
    "git *": allow
    "npm *": allow
    "*": ask
  edit: allow
  write: allow
---

You are a senior code reviewer...

Run without any flags to enter the interactive menu:

python migrate_agents.py

Options available:

1. Scan Claude Code agents
2. View existing OpenCode agents
3. Check synchronization status
4. Migrate all agents
5. Migrate a specific agent
6. Preview migration (dry-run)
7. View diff for an agent
8. Exit

# 1. See what you have
python migrate_agents.py --scan

# 2. Preview without writing anything
python migrate_agents.py --dry-run --migrate

# 3. Inspect specific agents if needed
python migrate_agents.py --diff code-reviewer

# 4. Execute the migration
python migrate_agents.py --migrate

# 5. Confirm everything is in sync
python migrate_agents.py --sync

After making changes to an agent in Claude Code, re-run:

python migrate_agents.py --migrate --force
python migrate_agents.py --sync

• Python 3.8+
• No external dependencies

MIT

Disclaimer This tool has been tested on the author's machine and works as expected. However, use it at your own risk. The author assumes no responsibility for any data loss, file corruption, or unintended modifications that may result from running this script. Always review what you execute on your own system, inspect the --dry-run output before migrating, and ensure you have proper backups of your agents before proceeding.

Built by Arkessiah