feat: add GPU and VRAM status modules by NyongCho · Pull Request #588 · catppuccin/tmux · GitHub
Skip to content

feat: add GPU and VRAM status modules - #588

Open
NyongCho wants to merge 6 commits into
catppuccin:mainfrom
NyongCho:feat/gpu-status-module
Open

NyongCho wants to merge 6 commits into
catppuccin:mainfrom
NyongCho:feat/gpu-status-module

Conversation

@NyongCho

@NyongCho NyongCho commented Apr 9, 2026

Copy link
Copy Markdown

Summary

  • add built-in GPU and VRAM status modules
  • document both modules and add test coverage

Why

Catppuccin tmux already exposes CPU and RAM modules via tmux-cpu, but it does not provide built-in modules for GPU utilization or GPU memory usage.
This is especially useful for local AI workloads, where CPU and system RAM alone are often not enough to understand actual system pressure.

Notes

  • the GPU module uses tmux-cpu's gpu_* placeholders
  • the VRAM module is user-facing as vram, and uses tmux-cpu's gram_* placeholders internally

Testing

  • SOCKET_NAME=tmuxforkgpu bash tests/harness.sh --test tests/gpu_module.sh --expected tests/gpu_module_expected.txt
  • SOCKET_NAME=tmuxvramcheck bash tests/harness.sh --test tests/vram_module.sh --expected tests/vram_module_expected.txt
  • SOCKET_NAME=tmuxvramfullcheck bash run_tests.sh
gpu_vram_status

NyongCho and others added 6 commits April 10, 2026 01:58
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
@arkottke

Copy link
Copy Markdown

@juliofihdeldev

Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants