close-mongo-ops-manager
Monitor and kill MongoDB operations (Be advised that this is in a Beta state. You may encounter some bugs.)
The app is also published in pypi
Requirements
Install uv
Once installed you should see something similar to this:
$ uv self version
uv 0.9.5 (d5f39331a 2025-10-21)
Sync Project Dependencies
Sync the project
uv sync --python 3.13
For development, you can use the --all-groups flag to install all dev dependencies
uv sync --python 3.13 --all-groups
Testing
Run tests
uv run pytest -v
Running the app
Launch the application
uv run src/close_mongo_ops_manager/app.py --help
Or you can just use uvx
uvx -n close-mongo-ops-manager
Command Line Options
The application supports these command line options:
--host: MongoDB host (default: localhost or MONGODB_HOST env var)--port: MongoDB port (default: 27017 or MONGODB_PORT env var)--username: MongoDB username (or MONGODB_USERNAME env var)--password: MongoDB password (or MONGODB_PASSWORD env var)--auth-source: MongoDB authentication database (default: admin or MONGODB_AUTH_SOURCE env var)--namespace: MongoDB namespace to monitor (default: ".*")--refresh-interval: Refresh interval in seconds (default: 2, min: 1, max: 10)--show-system-ops: Show system operations (disabled by default)--load-balanced: Enable load balancer support for MongoDB connections--version: Show version information--help: Show help information
Usage
These are the actions you can do in the app. You can see them in the app help menu as well.
f1 : Show this help
Ctrl+Q : Quit application
Ctrl+R : Refresh operations list
Ctrl+K : Kill selected operations
Ctrl+P : Pause/Resume auto-refresh
Ctrl+S : Sort by running time
Ctrl+L : View application logs
Ctrl+A : Toggle selection (select all/deselect all)
Ctrl+F : Toggle filter bar visibility
Ctrl+T : Change theme
Ctrl++ : Increase refresh interval
Ctrl+- : Decrease refresh interval
Enter : See operation details
Space : Select operations
The mouse is enabled, so all menus are clickable.
Auto-refresh is enabled by default. If you need a stable view while deciding what to kill, pause refresh with Ctrl+P.
Selected operations are preserved across refreshes while the same operation IDs are still present. There is also a known issue where the filter bar loses focus.
This is the typical usage:
- Use arrow keys or mouse to navigate
- Space/Click to select operations
- Filter operations using the input fields
- Clear filters with the Clear button
- Confirm kill operations when prompted
Theming
The application supports multiple themes that can be changed using Ctrl+T. Available themes include:
- textual-dark (default) - Standard dark theme
- textual-light - Standard light theme
- close-mongodb - Custom theme with MongoDB brand colors
- nord - Nord color scheme
- gruvbox - Gruvbox color scheme
- tokyo-night - Tokyo Night theme
- solarized-light - Solarized light theme
- dracula - Dracula theme
- monokai - Monokai theme
- flexoki - Flexoki theme
- catppuccin-mocha - Catppuccin Mocha theme
- catppuccin-latte - Catppuccin Latte theme
Theme preferences are automatically saved to ~/.config/close-mongo-ops-manager/config.json and will be restored when you restart the application.
Screenshot
Release files for close-mongo-ops-manager 0.5.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| close_mongo_ops_manager-0.5.7.tar.gz | 22.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| close_mongo_ops_manager-0.5.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 51.8 kB
Release files / close_mongo_ops_manager-0.5.7.tar.gz
| Download URL | close_mongo_ops_manager-0.5.7.tar.gz |
|---|---|
| Size | 22.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8ccc14b35e670ca719b0b22b2cb46981994df5eaa252b4daa0145189950fb9b9
|
|
BLAKE2b-256 checksum How to use checksums |
1a9f8d65a9a1b4440ad74725fdaa8dfd2971a4c0754cf54a7cc9aea5cbbc68f2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / close_mongo_ops_manager-0.5.7-py3-none-any.whl
| Download URL | close_mongo_ops_manager-0.5.7-py3-none-any.whl |
|---|---|
| Size | 29.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
86258469ebebfd6c6698172342408739fc684588147f6fdab289af5894f7f769
|
|
BLAKE2b-256 checksum How to use checksums |
f16febf641910d0da88c64738a7032ad1a8d173fc6d5745217545bb0cb650053
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|