amok

Amok(1)

Synopsis

amok [options] <script>

Description

Amok is a 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 as needed, and reloaded in the browser session without refreshing. This keeps the application state unchanged while doing live edits.

It does this by connecting directly to the browser via the debugging protocol, which means no browser extension are required, but the browser does have to support the remote debugging protocol (which, is currently only Chrome)

Example

export AMOK_BROWSER="google-chrome --remote-debugging-port=9222"
export AMOK_BUNDLER="watchify"
  
amok myapp.js

Options

-h, --host <HOST>
  specify the http host, default HOST is localhost.

-p, --port <PORT>
  specify the http port, default PORT is 9966.

-H, --debugger-host <HOST>
  specify the remote debugger host, default HOST is localhost.

-P, --debugger-port <PORT>
  specify the remote debugger port, default PORT is 9222.

-v, --verbose
  enable verbose logging mode

--no-browser
  disable browser spawning
    
--no-bundler
  disable bundling

--no-debugger
  disable remote debugger

Any extra arguments following the -- terminator, will be passed along with the invocation to the source bundler if one is specified.

Environment Variables

AMOK_BROWSER
  When set to a executable, will be opened after the server has started.

AMOK_BUNDLER
  When set to an executable, will be used to bundle scripts.