Hi,
On every gauge run, if there are failures they are recorded in a file : <ProjectRoot>/.gauge/failures.json. The "--failed" flag would look at your project directory and see if there is a .gauge/failures.json, and use it to rerun failed tests.
So typically you woudl use the "--failed" flag after a run with failed test. So the workflow would be something like this:
mkdir sample
cd sample
gauge --init java
# add your specs and implementations
gauge specs
# some failures!
gauge --failed specs
# rerun the failed tests
You can map this to your eclipse/jenkins setup. However, running --failed in a CI environment can be a sign of flaky test(s). So please consider that, and do not ignore the hint!
hope this helps
Srikanth