Who it is forA developer whose test database runs in a container and who does not remember its port or name.
The problemLooking up container ports and credentials by hand each time wastes time during local work.
The outcomeMasume lists the databases it finds, and you open one with a click or key press.
What you need first
- A terminal on macOS, Linux, or Windows
- A database you can reach, or a local SQLite file
- One install method: Homebrew, npm, Go 1.27 or later, or a release package
Steps
- Start the Docker or Podman container that runs your database
- Run
masume --detectto list databases in running containers and in the current kubectl context - Choose the database from the list and connect
- Run a query to confirm you are on the expected database
Prompt for your agent
In the masume repo, run `masume --detect` and report the databases it lists. Expected output: a list of detected databases. Verify that the database you expect appears, and that the container is running.
Caveat. Kubernetes detection uses kubectl port-forward as described in the README, so it depends on your kubectl context and access.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for masumedb/masume and "Find and open databases running in local containers"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer