What’s a legacy agent?
A legacy agent is any Forest agent prior to the current generation: the era when the product was branded as Forest and centered on building admin panels. The legacy agents are:| Agent | Language | Status |
|---|---|---|
forest-express-sequelize | Node.js + Sequelize | Maintenance only |
forest-express-mongoose | Node.js + Mongoose | Maintenance only |
forest-rails | Ruby on Rails | Maintenance only |
@forestadmin/agent
Node.js: TypeScript-first, multi-datasource, modern API.
forest_admin_agent
Ruby: ActiveRecord and Mongoid support, Rails integration.
Why we recommend migrating
The current agent generation is the foundation Forest is built on today. Legacy agents only expose the original admin-panel capabilities; the current agents add everything Forest has shipped since:- Multi-datasource support: combine SQL, MongoDB, APIs, and custom sources in a single agent.
- Workflows: orchestrate multi-step operational processes across humans, AI agents, and external systems.
- MCP server: expose your data, actions, and workflows to AI agents under governance.
- Decision traces: every action carries its full context, audit-ready by default.
- Better performance: query optimization and reduced overhead.
- Active development: new features, regular security updates, full support.
- Cleaner customization API: fewer concepts to learn, more composable.
- TypeScript (Node.js): full type inference for your collections and actions.
Where to start
Migration guide
Step-by-step migration from any legacy agent. Run v1 and v2 in parallel with zero downtime.
Agent SDK reference
Reference for the current agents.
Legacy reference
If you need to keep working in a legacy agent while you plan a migration:JavaScript (Express) agents
Reference for
forest-express-sequelize and forest-express-mongoose. Setup, customization, and how-tos for v1 Node.js agents.Ruby on Rails agent
Reference for
forest-rails. Setup, customization, and how-tos for the v1 Ruby agent.Migration guide
Step-by-step v1 → v2 migration paths per agent.
Need help migrating?
Migration guide
Full step-by-step instructions.
Community forum
Migration questions and patterns shared by other teams.
Support
Reach out to the Forest team directly.