Skip to main content
Do not start new projects with legacy agents. This section is preserved for teams maintaining existing v1 deployments and as a reference during migration to the current generation.

​
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:
AgentLanguageStatus
forest-express-sequelizeNode.js + SequelizeMaintenance only
forest-express-mongooseNode.js + MongooseMaintenance only
forest-railsRuby on RailsMaintenance only
These have been replaced by the current agent generation:

@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.