aksakalli/gtop

System monitoring dashboard for terminal

9,930

stars

77

commits

JavaScript

primary language

Nov 6, 2025

updated

command-line
monitoring
nodejs
system-monitoring
top
tui

README

gtop

screen record

System monitoring dashboard for terminal.

NPM Version NPM Downloads Snap Status Docker Pulls Docker Cloud Build Status

Requirements

  • Linux / OSX / Windows (partial support)
  • Node.js >= v8

Installation

$ npm install gtop -g

Docker

You need to assign host net and pid to access the metrics in the host machine.

$ docker run --rm -it \
    --name gtop \
    --net="host" \
    --pid="host" \
    aksakalli/gtop

Usage

Start gtop with the gtop command

$ gtop

To stop gtop use q, or ctrl+c in most shell environments.

You can sort the process table by pressing

  • p: Process Id
  • c: CPU usage
  • m: Memory usage

Troubleshooting

If you see question marks or other different characters, try to run it with these environment variables:

$ LANG=en_US.utf8 TERM=xterm-256color gtop

License

Released under the MIT license.

Contributors

aksakalli

57 commits

snpranav

6 commits

popey

3 commits

aksakalli/gtop

System monitoring dashboard for terminal

9,930

stars

77

commits

JavaScript

primary language

Nov 6, 2025

updated

command-line
monitoring
nodejs
system-monitoring
top
tui

README

gtop

screen record

System monitoring dashboard for terminal.

NPM Version NPM Downloads Snap Status Docker Pulls Docker Cloud Build Status

Requirements

  • Linux / OSX / Windows (partial support)
  • Node.js >= v8

Installation

$ npm install gtop -g

Docker

You need to assign host net and pid to access the metrics in the host machine.

$ docker run --rm -it \
    --name gtop \
    --net="host" \
    --pid="host" \
    aksakalli/gtop

Usage

Start gtop with the gtop command

$ gtop

To stop gtop use q, or ctrl+c in most shell environments.

You can sort the process table by pressing

  • p: Process Id
  • c: CPU usage
  • m: Memory usage

Troubleshooting

If you see question marks or other different characters, try to run it with these environment variables:

$ LANG=en_US.utf8 TERM=xterm-256color gtop

License

Released under the MIT license.

Contributors

aksakalli

57 commits

snpranav

6 commits

popey

3 commits

Languages

JavaScript

97.5%

Dockerfile

2.5%