Sometimes we need to pass some extra command line params to code executed.
As of now we have:

• nodeOptions
• mochaOptions
• istanbulOptions

none of them helps to achieve this goal.
Correct me if I'm wrong, but there's no possibility to add parameters at the and of args passed for execution. In other words, one cannot achieve something like this:

node_modules/istanbul/lib/cli.js cover --dir <some-dir> /node_modules/mocha/bin/_mocha -- target/test/specs/**/*.spec.js --some-extra-param

If I'm wrong and it's possible I'll be very much obliged if you'll show how it can be done.
If it is not, I suggest to add extraOptions (or whatever it will be named).

I can contribute.

in your README.md file, can you show a solid example of how to do this? What are the benefits of using mocha-istanbul versus plain old istanbul with Node.js?

At the moment this repo is ahead of the npm registry, and in the old version reporters cannot be selected.

=============================== Coverage summary ===============================
Statements : 92.85% ( 8005/8621 )
Branches : 84.35% ( 3159/3745 )
Functions : 91.15% ( 1925/2112 )
Lines : 92.97% ( 7706/8289 )

THE EXCEPTION BEING THROWN IS ERROR: Coverage for statements (68.9%) does not meet global threshold (75%)
ERROR: Coverage for lines (69.72%) does not meet global threshold (75%)

/Users/btineo/Desktop/myProject/node_modules/istanbul/lib/cli.js:39
throw ex; // turn it into an uncaught exception
^
ERROR: Coverage for statements (68.9%) does not meet global threshold (75%)
ERROR: Coverage for lines (69.72%) does not meet global threshold (75%)
Warning: Use --force to continue.

For example, I don't know what this means:

1...
2. Instrument your code using istanbul
3...

• A line showing the how to "run mocha using mocha-istanbul as the reporter"
• Explain where one would define the ISTANBUL_REPORTERS variable

Just noticed master is ahead of npm, and I really need the ISTANBUL_REPORT_DIR env var. Could you cut a 0.3.0 release please?

Istanbul supports mocha directly. Just run:

istanbul cover _mocha

or with arguments:

istanbul cover _mocha -- -R spec

See gotwarlost/istanbul#44 (comment) for info.

mocha-istanbul exists so that you can use mocha's HTML coverage reporters with istanbul.