RiNG 🎤
台灣華語 · English
Realtime Instance Notification Grid — one local board for all active agent-CLI sessions.
When several Claude Code, Codex, or local-model sessions are running, RiNG shows which ones are working, idle, or waiting for you. Sessions that need a response are sorted first.
🎤 RiNG — 3 sessions on stage · 2 agent processes running
🔴 maigo 12s → waiting for permission
🟢 pelican-osm 3s → Edit
🟡 commitizen 8m turn finished, idle
What It Does
- One board for session state: built-in sources for Claude Code and Codex, plus process-liveness detection for interactive Ollama and llama.cpp CLIs.
- Puts waiting sessions first: shows what 🔴 sessions need and sends desktop or phone notifications.
- Returns you to the right terminal: focuses tmux, iTerm2, Terminal.app, kitty, Neovim terminals, or Linux X11 windows from the TUI.
- Avoids an extra context switch: reply to permission requests in supported terminals and assign session names from the board.
- Fits existing workflows: status-bar output, JSON, a provider-neutral hook, and plugin extension points.
Get Started in Three Steps
Requires Python 3.13+:
uv tool install 'ring-cli[tui]'
ring --watch
ring install-hooks
ring --watchopens the interactive board. Select a session and pressEnterto return to its terminal.ring install-hooksinstalls Claude Code and Codex hooks for precise 🔴 waiting states and system notifications.- Restart agent sessions after installing hooks. RiNG can then notify you even while its board is closed.
Use pipx install 'ring-cli[tui]' if you prefer pipx. Run ring for a one-shot snapshot.
Common Operations
| Operation | Purpose |
|---|---|
ring |
Print a snapshot of every current session |
ring --watch |
Open the continuously updating interactive TUI |
Enter / Space |
Return to the selected session's terminal |
p |
Reply to the selected session's permission request in place |
n |
Name the selected session |
ring doctor |
Check hooks, notifications, and terminal focus support |
ring --format oneline |
Produce a summary for tmux, SwiftBar, or waybar |
Zero-config mode works without hooks. Precise 🔴 waiting states, pending details, and immediate notifications require hooks. Restart Claude Code or Codex sessions after installing or updating them.
Learn More
- Full guide: commands, TUI controls, hooks, notifications, configuration, extensions, and privacy
- Session states: how RiNG derives 🔴/🟢/🟡/⚫
- Contributing guide: development setup, tests, and PR checklist
RiNG supports macOS and Linux; Windows is not yet supported. By default it only reads local agent data and writes ~/.config/ring/. Network access occurs only for ntfy or webhook notifiers you configure.
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for ring-cli 0.17.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ring_cli-0.17.4.tar.gz | 157.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ring_cli-0.17.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 359.0 kB
Release files / ring_cli-0.17.4.tar.gz
| Download URL | ring_cli-0.17.4.tar.gz |
|---|---|
| Size | 157.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
18cc9b2938c586efb30ee7a6da5531b48549f4b1b2430c99aba90cdcbd7b9763
|
|
BLAKE2b-256 checksum How to use checksums |
899143a2b917d617a45b84fbdf28566962eadba275df4d5bb8b05fe85ba9c9e5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / ring_cli-0.17.4-py3-none-any.whl
| Download URL | ring_cli-0.17.4-py3-none-any.whl |
|---|---|
| Size | 201.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b9d28617454ae91b590f5fbe9b9fa8de0a08c6ef22be49c929336542f68159a3
|
|
BLAKE2b-256 checksum How to use checksums |
ba69bcbdaaf859d6ae531d2d03a2461106171dc60521445419e5b6ff85358ac3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency log
