neo-vtop 1.0.1

package/.github/workflows/ci.yml

@@ -0,0 +1,20 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: yarn
+      - run: yarn install --frozen-lockfile
+      - run: yarn lint
+      - run: yarn prettier --check .

package/.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged

package/.npm_ignore

@@ -0,0 +1 @@
+node_modules

package/.prettierrc

@@ -0,0 +1,5 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "printWidth": 100
+}

package/CHANGELOG.md

@@ -0,0 +1,81 @@
+# Changelog
+
+## 1.0.1 - 2025
+
+- Forked from vtop
+- Rewritten in TypeScript
+- Replaced `blessed` with `neo-blessed`
+- Updated all dependencies to modern versions
+- Removed auto-updater
+- Added ESLint, Prettier, and Husky
+- ESM support
+- Both `vtop` and `neo-vtop` commands supported
+
+## 0.5.0
+
+- Upgrade drawille and blessed deps
+
+## 0.4.10
+
+- Fix for issue #2 where people had set a different TERM variable
+
+## 0.4.6
+
+- Fix for systems that called the node binary 'nodejs'
+
+## 0.4.0
+
+- Add sort by CPU and Memory
+
+## 0.3.3
+
+- Fix bug after auto update showing multiple selected items
+
+## 0.3.2
+
+- Add colors for item selection to the other themes
+
+## 0.3.1
+
+- Add keyboard and mouse support
+- Add killall support
+
+## 0.2.8
+
+- Improve Makefile
+
+## 0.2.7 - 2014-06-12
+
+- Add Becca theme. http://www.zeldman.com/2014/06/10/the-color-purple/
+
+## 0.2.6 - 2014-06-11
+
+- Fix major perf problem that some users were having relating to
+  drawing the header for update notifications.
+
+## 0.2.5
+
+- Delete old data points to improve performance
+
+## 0.2.4, 0.2.3, 0.2.2 - 2014-06-11
+
+- Fixes to the upgrade script
+- Added --version and -V command line arguments for version
+
+## 0.2.0 - 2014-06-11
+
+- Add new theme 'dark'
+- Add auto-update mechanism
+
+## 0.1.7 - 2014-06-11
+
+- Add a fix for user submitted ps outputs - #5 #6 #7
+- Fix issue with 'NaN' appearing for some users
+
+## 0.1.4 - 2014-06-09
+
+- Slice the row strings smaller in table view
+
+## 0.1.0 - 2014-06-08
+
+- First release

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 James Hall, Parallax Agency Ltd, 2026 Vincent, NexusOcean
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,98 @@
+# Neo VTop
+
+A graphical activity monitor for the command line. A neo fork of [vtop](https://github.com/MrRio/vtop) rewritten in TypeScript with updated dependencies.
+
+![](https://raw.githubusercontent.com/MrRio/vtop/master/docs/example.gif)
+
+## Installation
+
+Requires Node.js >= 24.
+
+> ⚠️ If you have the legendary [vtop](https://github.com/MrRio/vtop) installed, `neo-vtop` will replace the `vtop` command. Uninstall it first with `npm uninstall -g vtop`, or just let neo-vtop take over — it's more based anyway.
+
+```bash
+npm install -g neo-vtop
+```
+
+If you're on macOS, or get an error about file permissions, you may need to do `sudo npm install -g neo-vtop`. Don't do this if you're using [nvm](https://github.com/nvm-sh/nvm).
+
+## Running
+
+```bash
+neo-vtop
+# or
+vtop
+```
+
+If your muscle memory keeps typing `top`:
+
+```bash
+alias top="vtop"
+alias oldtop="/usr/bin/top"
+```
+
+## Keyboard shortcuts
+
+- Arrow up or `k` — move up the process list
+- Arrow down or `j` — move down
+- Arrow left or `h` — zoom graphs in
+- Arrow right or `l` — zoom graphs out
+- `g` — jump to top of process list
+- `G` — jump to bottom
+- `dd` — kill all processes in that group
+- `c` — sort by CPU
+- `m` — sort by memory
+- `q` / `esc` / `Ctrl+C` — quit
+
+## Mouse control
+
+If your terminal supports mouse events (like iTerm) you can click items in the process list and use the scroll wheel. Disable with:
+
+```bash
+neo-vtop --no-mouse
+```
+
+## Themes
+
+```bash
+neo-vtop --theme wizard
+```
+
+Themes live in the `themes/` folder. Make your own and send a pull request.
+
+```bash
+alias vtop="vtop --theme brew"
+```
+
+## FAQ
+
+### How does it work?
+
+It uses [drawille](https://github.com/madbence/node-drawille) to draw CPU and memory charts with Unicode braille characters. Processes with the same name are grouped together.
+
+### The CPU % looks wrong.
+
+CPU is calculated as a percentage of total system power across all cores and HyperThreads. 100% means all cores maxed out — this differs from how Activity Monitor on macOS reports it.
+
+### What about measuring server req/s, log entries, etc?
+
+It's on the list. Feel free to send a pull request — check out the `sensors/` folder.
+
+### What license is this under?
+
+MIT — do what you like with it.
+
+## Contributing
+
+Fork, clone, then:
+
+```bash
+yarn install
+yarn start
+```
+
+ESLint and Prettier run on commit via Husky. Make sure `yarn lint` passes before opening a PR.
+
+## Credits
+
+Originally created by [James Hall](https://github.com/MrRio/vtop). Modernized and maintained by [nexusocean8](https://github.com/nexusocean8/neo-vtop).