environments:reset

This is the official documentation of the @forestadmin/agent Node.js agent.

The forest environments command is very useful as it allows you to manage your environments. But the subcommand that we're more specifically interested in when it comes to developing on Forest Admin is:

$ forest environments:reset --help
Reset a remote environment by removing all layout changes

USAGE
  $ forest environments:reset

OPTIONS
  -e, --environment=environment  The remote environment name to reset.
  -p, --projectId=projectId      The id of the project to work on.
  --force                        Skip reset changes confirmation.

As you've learned in previous pages, the forest push command lets you push changes made in the layout to a Remote Environment and later deploy them to your Production.

Sometimes though, there comes a time when you have stacked too many layout changes on a Remote Environment and just want to get rid of them.

Unlike a branch which you can just dispose of, for a Remote Environment you need a way to clean the layout changes easily. This is where the forest environments:reset command comes in.