Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
98 lines (66 sloc) 1.88 KB
id title
Getting started

esy provides a single command called esy that can be invoked inside of any directory containing a package.json file. The typical workflow is to cd into a directory that contains a package.json file, and then perform operations on that project.

When running esy commands in that directory, esy creates and manages isolated build environment for your package called a "sandbox". Each sandbox, in each directory is isolated from every other sandbox.

Here are two example projects:

Install esy

npm install -g esy

If you had installed esy previously:

npm uninstall --global --update esy

Clone & initialize the project

Clone the project source code

git clone
cd hello-reason

Install project's dependencies source code and perform an initial build of the project's dependencies and of the project itself:


Run compiled executables

Use esy x COMMAND invocation to run project's built executable as if they are installed:

esy x Hello

Rebuild the project

Hack on project's source code and rebuild the project:

esy build

Other useful commands

It is possible to invoke any command from within the project's sandbox. For example build & run tests with:

esy make test

You can run any COMMAND inside the project development environment by just prefixing it with esy:


To shell into the project's development environment:

esy shell

For more options:

esy help
You can’t perform that action at this time.