What is bg-tasks?
bg-tasks is a Claude Code mod by KilimcininKorOglu that shows the background shell tasks of the session on the status line or in the shared sidebar, with the oldest one's age, and stops one from the /bg-tasks pane. It is listed under Interface and has 11 GitHub stars.
| Type | Claude code mod |
|---|---|
| Author | KilimcininKorOglu |
| Repository | KilimcininKorOglu/claude-code-mods |
| Popularity | 11 GitHub stars |
| Category | Interface |
| Security | Low risk (84/100) |
| Rank | #453 of 5,272 Claude Code mods; #173 in Interface |
| License | MIT |
| Last commit | 2026-10-04 |
| Stars this week | +3 |
| Hooks | 7 events |
| Sees | Bash calls, TaskStop calls, every prompt |
| Draws on | Pane |
Is bg-tasks safe to install?
bg-tasks scores 84/100 on the MCPMods security check: Low risk. Things to review: watches every prompt or event. It passed 6 of 8 checks.
Mod footprints come from claude plugin validate, which lists every event a mod hooks and every API call it makes without running it.
| Check | Result |
|---|---|
| No network access | Pass |
| Starts no processes | Pass |
| Writes no files or config | Pass |
| Doesn't read environment variables | Pass |
| Watches every prompt or event | Review |
| Drives Claude (model calls, prompts) | Note |
| Passes claude plugin validate | Pass |
| Has an open-source license | Pass |
API calls in its code
| Call | What it means |
|---|---|
$.clock.every | |
$.clock.now | |
$.command.register | |
$.session.messages | reads the transcript |
$.sidebar.clear | |
$.sidebar.set | |
$.store.get | keeps its own state |
$.store.set | keeps its own state |
$.tool.call | drives Claude |
$.ui.close | draws interface |
$.ui.invalidate | draws interface |
$.ui.open | draws interface |
$.ui.panes | draws interface |
$.ui.resolve | draws interface |
$.ui.status | draws interface |
How do I install bg-tasks?
- Check your Claude Code version. Mods need Claude Code 2.1.287 or later and are on by default.
claude --version
- Read its footprint. This lists every event it hooks and every API call it makes, without running it.
git clone https://github.com/KilimcininKorOglu/claude-code-mods claude plugin validate ./claude-code-mods/plugins/bg-tasks
- Install it. Run this in your terminal, then /reload-plugins in an open session.
claude plugin marketplace add KilimcininKorOglu/claude-code-mods && claude plugin install bg-tasks@kilimcininkoroglu-mods
Or ask Claude to set it up
Paste this into Claude Code and it installs bg-tasks for you:
Install the "bg-tasks" Claude Code mod from https://github.com/KilimcininKorOglu/claude-code-mods/tree/main/plugins/bg-tasks. Run claude plugin validate on it first and show me what it can access before you enable it.
More from KilimcininKorOglu/claude-code-mods
This repository has at least 9 Claude Code mods on MCPMods.
- action-pin: After an edit that adds a GitHub Actions step pinned to a tag or a branch, names the commit SHA to write instead, from t (Review before installing)
- ask-autopick: Picks the recommended option of a question that waited unanswered for a set time, so a session you left does not stop. O (Low risk)
- bash-diet: Shrinks each Bash result before the model reads it: per-command filters for git, test runners, linters, package managers (Review before installing)
- bughunt: Runs proof-driven bug hunt rounds with /bughunt: each round proves one bug with a failing command the mod runs itself, f (Review before installing)
- cache-warm: Keeps the 1-hour prompt cache warm for a window you set, or with no end in every session under always, with one cache-sh (Review before installing)
- commit-cadence: Names the uncommitted files to you at the end of each turn, and tells the model at the next prompt to commit each finish (Review before installing)
- config-parse: Parses each JSON, YAML, TOML or .env file an Edit or Write touches, notes a parse error at once instead of at the next b (Review before installing)
- context-restore: Hands a skill or command call the current text of its file when the file changed on disk after the session loaded it, an (Review before installing)