alihalabyah / amok

No Reload, Live Editing for JavaScript

Amok(1)

Synopsis

amok [options] <script>

Installation

npm install amok -g

Description

Amok standalone command line tool for rapid prototyping and development of JavaScript applications.

It monitors changes in the file system. As soon as you save a file, it is then preprocessed, compiled and bundled as needed, the code is then refreshed in the client while it is running without restarting or reloading the client.

This re-compilation is done through a remote debugging session, which leverages the re-compilation capabilities built into the runtime itself. Doing re-compilation has several advantages over reloading and hot replacement, application state is kept, no side effects are executed, and there is no code that cannot be edited live, including anonymous closures.

It also has a zero configuration http development server for developing front end applications, this server will automatically generate an appropriate index.html file if one is not found.

Additional features include an interactive mode (read–eval–print loop) and console redirection.

Options

-h, --help
  output usage information

-V, --version
  output the version number

--host <HOST>
  specify http host

--port <PORT>
  specify http port

--debugger-host <HOST>
  specify debugger host

--debugger-port <PORT>
  specify debugger port

-i, --interactive
  enable interactive mode

--client <ID | CMD>
  specify the client to spawn

--compiler <ID | CMD>
  specify the compiler to spawn

-v, --verbose
  enable verbose logging mode

You must have a client already listening on the remote debugging port when launching, or specified via the client option.

Optionally a compiler may be specified to process script sources via the compiler option, Any extra arguments and options following the option parsing terminator --, will be passed as extra options to the compiler. The specified compiler must have its executable available via PATH.

Example

1. git clone https://gist.github.com/d58c3eecb72ba3dd0846.git examples
2. cd examples
3. amok --client chrome canvas.js

Webpack

amok --client chrome --compiler webpack canvas.js

Browserify

amok --client chrome --compiler browserify canvas.js

Babel

amok --client chrome --compiler babel canvas.js

TypeScript

amok --client chrome --compiler typescript canvas.ts

CoffeeScript

amok --client chrome --compiler coffeescript canvas.coffee