litmus-cli

Official CLI for Litmus engineering assessments.

Installation

npm install -g litmus-cli

Requires Node.js 18+.

Usage

Initialize an assessment

litmus init <token>

• Downloads the assessment package
• Installs dependencies automatically
• Initializes a git repo with an initial commit
• Starts background file tracking
• Your timer begins when you run this command

Your token is provided on the Litmus candidate portal when you open your assessment.

Check your status

litmus status

Run this from inside your assessment folder to see:

• Time elapsed and remaining
• Deadline info
• Git commit stats
• Estimated submission size
• Tracker status

Submit your work

litmus submit

Run this from inside your assessment folder when you're done. It packages your work (source code + git history + activity log) and uploads it automatically. The assessment folder is deleted after a successful submission.

Use litmus submit --yes to skip the confirmation prompt.

How it works

1. litmus init <token> — sets up your workspace and starts the clock
2. Work in your preferred editor, committing frequently
3. litmus status — check your progress and time remaining
4. litmus submit — packages and uploads everything in one step

Your git commit history and file activity are included in the submission and used as part of the evaluation. Frequent, meaningful commits are recommended.

Requirements

• Node.js 18+
• Git (recommended — analysis degrades gracefully without it)