Skip to main content

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

App screenshot

Release files for close-mongo-ops-manager 0.5.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for close-mongo-ops-manager 0.5.8
File Size Uploaded
close_mongo_ops_manager-0.5.8.tar.gz 22.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for close-mongo-ops-manager 0.5.8
File Interpreter ABI Platform
close_mongo_ops_manager-0.5.8-py3-none-any.whl Python 3 none any Details

Total release size: 52.3 kB

Release files / close_mongo_ops_manager-0.5.8.tar.gz

Download URL close_mongo_ops_manager-0.5.8.tar.gz
Size 22.8 kB
Tags Source
SHA-256 checksum
How to use checksums
eb323dca9f913f9022d9ac1ff1b45ade6e78dde58a8a2fdf0e5806ed08eb55d4
BLAKE2b-256 checksum
How to use checksums
994e89f614d0d7319c46baa52276299adbc74ef1aa506a0686599d92ba9ceea8
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.8-py3-none-any.whl

Download URL close_mongo_ops_manager-0.5.8-py3-none-any.whl
Size 29.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
564b2839282ecbc2a002572e522f82ffceecf2e822dca996250041d9283b5a1a
BLAKE2b-256 checksum
How to use checksums
688ecb433ce3d24df946f8b22b45385a093f28e3f03921cf16fcd1b38f808640
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 history Release notifications | RSS feed

This release

0.5.8 This release

2 release files

0.5.7

2 release files

0.5.6

2 release files

0.5.5

2 release files

0.5.4

2 release files

0.5.3

2 release files

0.5.2

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.4

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.38

2 release files

0.1.37

2 release files

0.1.36

2 release files

0.1.33

2 release files

0.1.32

2 release files

0.1.31

2 release files

0.1.30

2 release files

0.1.29

2 release files

0.1.28

2 release files

0.1.27

2 release files

0.1.26

2 release files

0.1.25

2 release files

0.1.24

2 release files

0.1.23

2 release files

0.1.22

2 release files

0.1.21

2 release files

0.1.20

2 release files

0.1.19

2 release files

0.1.18

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page