Migration Support
Migration from Eve is automated through two CLI tools:
Scanner
npx flue-eve scanAnalyzes the project for Eve patterns and classifies them into four tiers:
| Tier | Description | Migration |
|---|---|---|
| 0 | useEveAgent, eve/client browser imports | Zero-touch |
| 1 | instructions.md, tools/*.ts, eve.config.ts | Auto-scaffold |
| 2 | Complex tool patterns, non-standard layout | Manual review |
| 3 | Workflow SDK, channels, schedules | Blocked |
Use --strict to fail CI on Tier 2/3 findings:
npx flue-eve scan --strictInitializer
npx flue-eve initCreates or updates:
- Flue agent definition from
agent/instructions.md - Tool adapters from
agent/tools/*.ts - Connection adapters from
agent/connections/*.ts - Eve compat sidecar (
src/flue-eve-shim.ts) - Auto-injects
mountEveCompat(app)intosrc/app.ts
Idempotent — safe to re-run. Existing files are not overwritten unless --force is passed.
AI-assisted migration
A skills.sh-compatible migration skill is bundled in the repo. Install it and ask your AI coding agent to handle the full migration:
npx skills add doeixd/flue-eveSee migrate an existing Eve agent for the step-by-step walkthrough and migration tiers for the tier reference.