https://github.com/obeone/scripts

Collection of self-contained Python & shell utilities — Kubernetes debugging, OpenAI usage reports, Proxmox monitoring, and more.
https://github.com/obeone/scripts

cli devops kubernetes openai proxmox python utilities

Last synced: 5 days ago
JSON representation

Collection of self-contained Python & shell utilities — Kubernetes debugging, OpenAI usage reports, Proxmox monitoring, and more.

• Host: GitHub
• URL: https://github.com/obeone/scripts
• Owner: obeone
• License: mit
• Created: 2025-06-04T19:08:38.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2026-04-16T02:15:31.000Z (about 2 months ago)
• Last Synced: 2026-04-16T04:22:08.576Z (about 2 months ago)
• Topics: cli, devops, kubernetes, openai, proxmox, python, utilities
• Language: Python
• Size: 354 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
![Python](https://img.shields.io/badge/Python-3.7+-blue?logo=python&logoColor=white)

![Bash](https://img.shields.io/badge/Bash-scripts-4EAA25?logo=gnu-bash&logoColor=white)

![License](https://img.shields.io/badge/License-MIT-green)

![GitHub Stars](https://img.shields.io/github/stars/obeone/scripts?style=flat&logo=github)

# scripts

A monorepo of self-contained Python and shell utilities for Kubernetes debugging, cloud cost inspection, virtualization monitoring, and more.

---

```mermaid

flowchart TB

    ROOT["obeone/scripts"]

    ROOT --> KDBG["kdbg\nKubernetes debug containers"]

    ROOT --> USAGE["openai-usage\nOpenAI cost inspector"]

    ROOT --> DK["docker-kubernetes\nDocker-in-Kubernetes port wrapper"]

    ROOT --> PVE["proxmox/"]

    ROOT --> SS["slideshow\nTkinter image slideshow"]

    ROOT --> TRF["transfer.sh\nCLI for transfer.sh"]

    PVE --> MW["migration-watcher\nLive migration monitor"]

    PVE --> RW["restore-watcher\nRestore task dashboard"]

```

---

## Projects

| Icon | Project | Lang | Description |

|------|---------|------|-------------|

| 🐛 | [**kdbg**](kdbg/README.md) | Python 3.8+ | Interactive CLI to launch privileged debug containers against Kubernetes pods. Wraps `kubectl debug` with fzf selection and PSA management. PyPI: `kdbg` |

| 📊 | [**openai-usage**](openai-usage/README.md) | Python 3.10+ | Inspect OpenAI API token usage and costs per project/model/key. Color-coded terminal table with live pricing from litellm. PyPI: `openai-usage-report`. Docker available. |

| 🐳 | [**docker-kubernetes**](docker-kubernetes/README.md) | Bash | Wrapper for `docker` that auto-exposes ports on a Kubernetes service when running Docker-in-Kubernetes (DinD). |

| 📡 | [**proxmox/migration-watcher**](proxmox/migration-watcher/README.md) | Python 3.7+ | Monitor Proxmox QEMU live migrations with a real-time text-based speed graph. |

| 🔄 | [**proxmox/restore-watcher**](proxmox/restore-watcher/README.md) | Python 3.8+ | Monitor Proxmox restore tasks with a tqdm-style progress dashboard. |

| 🖼️ | [**slideshow**](slideshow/README.md) | Python 3.9–3.11 | Tkinter image slideshow with GIF support, shuffle, and brightness control. |

| 🚀 | [**transfer.sh**](transfer.sh/README.md) | Bash | Feature-rich CLI for transfer.sh: upload, download, delete, encrypt, progress bars. |

---

## Installation

### Python tools — install directly from GitHub with uv (recommended)

No clone needed:

```bash

uv tool install 'https://github.com/obeone/scripts.git#subdirectory='

```

| Tool | Command |

|------|---------|

| kdbg | `uv tool install 'https://github.com/obeone/scripts.git#subdirectory=kdbg'` |

| openai-usage | `uv tool install 'https://github.com/obeone/scripts.git#subdirectory=openai-usage'` |

| pve-migration-watcher | `uv tool install 'https://github.com/obeone/scripts.git#subdirectory=proxmox/migration-watcher'` |

| pve-restore-watcher | `uv tool install 'https://github.com/obeone/scripts.git#subdirectory=proxmox/restore-watcher'` |

| slideshow | `uv tool install 'https://github.com/obeone/scripts.git#subdirectory=slideshow'` |

`pipx` works as a drop-in replacement if you prefer it.

### Shell scripts

For `docker-kubernetes` and `transfer.sh`, clone the repo and follow the instructions in each project's `README.md`.

---

## Development

```bash

git clone https://github.com/obeone/scripts.git

cd scripts/

uv venv && source .venv/bin/activate

uv pip install -e .

```

Each sub-project is fully self-contained with its own `pyproject.toml` and dependencies.

---

## License

MIT — [Grégoire Compagnon (obeone)](https://github.com/obeone)