Skip to content
Limit the CPU usage of a process.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Remove node-priority. Update README. Dec 14, 2016
LICENSE Update Jun 5, 2017
package.json Update package.json May 15, 2017


A module which limits the CPU usage of a process. Useful when your computer is performing some heavy work that takes too much of the CPU cycles but you want to perform other tasks. It works by sending SIGSTOP and SIGCONT signals at regular intervals depending on the specified limit.


As a program

npm install -g cpulimit

cpulimit -l <percent> [-w <work-dir>] [-i] (-p <process id> | -c <command> | -- <command> <args>)


    -h, --help              output usage information
    -V, --version           output the version number
    -l, --limit <percent>   the CPU usage as a percent (0 - 100)
    -p, --pid <process id>  limit by process id
    -c, --cmd <command>     limit by command name
    -- <command> <args>     spawn this command with these arguments and limit it
    -w, --wdir <directory>  set the current working directory of the spawned process
    -i, --include-children  also limit child processes.

As a library

npm install --save cpulimit

var limiter = require('cpulimit');

var options = {
    limit: 20,
    includeChildren: true,
    pid: 2324

limiter.createProcessFamily(options, function(err, processFamily) {
    if(err) {
        console.error('Error:', err.message);

    limiter.limit(processFamily, options, function(err) {
        if(err) {
            console.error('Error:', err.message);
        else {

options object having some of these properties:

  • limit (required) the CPU usage as a percent (0 - 100)
  • includeChildren also limit child processes
  • pid limit by process id
  • command limit by command name
  • spawn object with the following properties:
    • command command name
    • args array with the arguments
    • cwd working directory

Similar projects

You can’t perform that action at this time.