MongoDB exploration with agent-mongo

agent-mongo is a read-only CLI binary on $PATH. Default output is NDJSON — one JSON record per line on stdout. List commands emit one record per item, then @-prefixed metadata lines ({"@meta": ...} for context, {"@pagination": ...} for paging). Errors go to stderr as one JSON line {"error": "...", "fixable_by": "agent"|"human"|"retry", "hint": "..."} with a non-zero exit.

fixable_by tells you who resolves the error: agent — fix your input and retry; human — needs the user (auth, a GUI dialog); retry — transient, run it again.

Quick start (connections)

Set up a connection:

agent-mongo connection add local "mongodb://localhost:27017/myapp" --default
agent-mongo connection test

For authenticated connections, store credentials separately — prefer --form (native OS dialog; the secret never enters agent context) over --username/--password flags: