Skip to content
Back to search

claude-gpu-panel

MarketplaceWorks with Claude CodeGitHub

A Claude Code panel for people who share a GPU server: which cards are busy and who is on them, your training jobs, plan limits and context — under the prompt. | GPU 서버를 나눠 쓰는 사람을 위한 Claude Code 패널.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tom0266--claude-gpu-panel/badge.svg)](/listings/tom0266--claude-gpu-panel)

HTML

<a href="/listings/tom0266--claude-gpu-panel"><img src="/api/listings/tom0266--claude-gpu-panel/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Needs Claude Code 2.1.287 or later.

claude plugin marketplace add tom0266/claude-gpu-panel
claude plugin install gpu-panel@claude-gpu-panel

Then `/reload-plugins` in an open session, or start a new one.

GPU and job fields appear only when the machine can produce them:

- **GPU** needs `nvidia-smi` on your `PATH`. Without it the field is hidden, so the panel still works on a laptop. - **Jobs** needs `~/.claude/statusline-jobs.txt`, one pattern per line. A line matches if it appears anywhere in a process's command. Blank lines and lines starting with `#` are ignored.

  # ~/.claude/statusline-jobs.txt
  train.py
  finetune
  optuna

Only your own processes are counted, and identical command lines are counted once.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 16 lines
  1. {
  2. "name": "claude-gpu-panel",
  3. "owner": {
  4. "name": "tom0266"
  5. },
  6. "plugins": [
  7. {
  8. "name": "gpu-panel",
  9. "source": "./gpu-panel",
  10. "description": "A panel under the prompt for shared GPU servers: which cards are busy and who is on them, your running training jobs, plan limits and context, with effort/model/compact buttons."
  11. }
  12. ],
  13. "metadata": {
  14. "description": "A Claude Code panel for people who share a GPU server."
  15. }
  16. }
README.md · README · 139 lines
  1. # gpu-panel
  2. ![gpu-panel: which GPUs are busy and who is on them, under your Claude Code prompt](assets/banner.png)
  3. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  4. ![Requires Claude Code 2.1.287+](https://img.shields.io/badge/Claude%20Code-2.1.287%2B-555)
  5. ![Needs nvidia-smi for the GPU fields](https://img.shields.io/badge/GPU-nvidia--smi-76B900)
  6. A Claude Code panel for people who share a GPU server.
  7. One line under your prompt shows which GPUs are busy, how many training jobs you
  8. have running, and how much of your plan is left. Click `gpu` and a pane opens
  9. with every card, who is using it, and your jobs with their elapsed time.
  10. [한국어](README.ko.md)
  11. ![The panel under the prompt: session name, 5h and 7d plan usage, context, busy GPUs, agents, and effort, model and compact buttons](assets/panel.png)
  12. A real session. Cards 2 and 3 are busy at 13%; the other two are free and stay out of the line.
  13. Most panels like this live above the prompt and show plan usage. This one sits
  14. below the prompt, next to the hint line, and its first concern is the machine
  15. you are sharing with other people.
  16. ## What it shows
  17. **The line under your prompt**
  18. | Field | Meaning |
  19. |---|---|
  20. | session name | from `/rename`, or the auto-generated title |
  21. | `5h` `7d` | plan usage with a bar and the time until reset |
  22. | `ctx` | how full the context window is |
  23. | `gpu` | busy cards only, as `index:utilization` or `index:memory`; `free` when none |
  24. | `job` | how many of your watched training jobs are running; hidden at zero |
  25. | `agents` | running subagents by model, plus done and failed counts |
  26. | buttons | switch effort, switch model, run `/compact` |
  27. The model buttons learn their version numbers from models you actually use, so
  28. `opus` becomes `opus 5.5` once you have run it, and the version is remembered
  29. between sessions. Nothing is hardcoded, so it does not go stale.
  30. Below 110 columns the panel drops its border, bars and labels and fits in two
  31. lines. Three cards wide in a split pane still works.
  32. **The `gpu` pane** — click the `gpu` field or run `/gpu`
  33. ```
  34. GPU
  35. 0 ━━━━━━━━ 0% 0/45G 31°C
  36. free
  37. 2 ━ 15% 1/48G 54°C
  38. you 1G, alice 22G
  39. Jobs
  40. 2733273 4-02:11:08 python train.py --fold 3
  41. ```
  42. <img src="assets/gpu-pane.png" width="360" alt="The real GPU pane on an idle four-card server: each card at 0% and marked free">
  43. The block above shows the layout with example accounts. This is the pane itself, on a server where all four cards happen to be free.
  44. Every card with its utilization, memory, temperature, and **the account using
  45. it**, so you can see at a glance whether the card you want is free or someone
  46. else's run is on it. Under that, your own watched jobs with PID and elapsed
  47. time. The pane refreshes every ten seconds while it is open, and runs no queries
  48. at all while it is closed.
  49. ## Install
  50. Needs Claude Code 2.1.287 or later.
  51. ```bash
  52. claude plugin marketplace add tom0266/claude-gpu-panel
  53. claude plugin install gpu-panel@claude-gpu-panel
  54. ```
  55. Then `/reload-plugins` in an open session, or start a new one.
  56. GPU and job fields appear only when the machine can produce them:
  57. - **GPU** needs `nvidia-smi` on your `PATH`. Without it the field is hidden, so
  58. the panel still works on a laptop.
  59. - **Jobs** needs `~/.claude/statusline-jobs.txt`, one pattern per line. A line
  60. matches if it appears anywhere in a process's command. Blank lines and lines
  61. starting with `#` are ignored.
  62. ```
  63. # ~/.claude/statusline-jobs.txt
  64. train.py
  65. finetune
  66. optuna
  67. ```
  68. Only your own processes are counted, and identical command lines are counted
  69. once.
  70. ## Commands
  71. | | |
  72. |---|---|
  73. | `/gpu` | open the GPU and jobs pane |
  74. Everything else is a click.
  75. ## What it costs
  76. The panel reads plan usage and context from events Claude Code already raises,
  77. so those are free. On a timer it runs `nvidia-smi` and `ps` every ten seconds,
  78. and greps the session transcript for its title every thirty. It makes no network
  79. requests and calls no model.
  80. ## Configuration
  81. Set these when you install, or later with `claude plugin configure gpu-panel@claude-gpu-panel`.
  82. | Option | Default | What it does |
  83. |---|---|---|
  84. | `language` | `en` | Language of the usage toast, the `/gpu` description and the pane's empty states: `en` or `ko`. The panel's own labels (`5h`, `ctx`, `gpu`) do not change |
  85. | `palette` | `dark` | `dark` uses fixed colors tuned for a dark terminal. `theme` follows the Claude Code theme, so it also reads on a light background |
  86. | `fiveHourThreshold` | `80` | Toast once per window when 5-hour usage reaches this percentage |
  87. | `sevenDayThreshold` | `70` | The same for the 7-day window |
  88. | `hideQuietStatus` | `false` | Hide status lines from other mods that only say nothing is wrong (`no active cases`, `waste≈0`). Warnings always stay. Off by default, because it removes another mod's output |
  89. A threshold outside 1 to 100 falls back to its default.
  90. ## Limits
  91. - Drawn in the terminal and the Desktop app's Code tab. `claude -p` and cloud
  92. sessions run the hooks but draw nothing.
  93. - The GPU pane shows accounts, not people. On a machine where everyone shares
  94. one account it tells you less.
  95. - Effort is tracked by watching `/effort` and the panel's own buttons. Claude
  96. Code does not expose the current level, so if it is changed another way the
  97. highlight can fall out of step until the next change.
  98. ## License
  99. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.