Skip to content
miudb

Overview

miudb keeps connections, secrets, tunnels, adapters, query execution, schema inspection, and machine-readable output in a Go core that can be driven from the shell, Neovim, or future UIs. Start with Install, or jump to the Agent CLI.

What’s inside

Daily Driver SQLite, PostgreSQL, MySQL, Snowflake, BigQuery, and SSH tunnels.
Headless Core Config, secrets, adapters, tunnels, workers, and result paging.
Agent Contract Stable JSON envelopes, bounded query output, and redacted errors.
MCP Server Local stdio tools and resources for Codex, Claude Code, Cursor, and VS Code.

Core Model

  • The Go CLI is named miudb.
  • Native config lives under ~/.config/miu/db.
  • Sensitive values are classified before persistence.
  • New credentials use the miudb OS Keychain/keyring service by default.
  • Migrated file credentials can stay in credentials-export.json.
  • SSH tunnel-backed connections are first-class for TCP adapters.

Interfaces

  • CLI and agents use JSON envelopes on stdout.
  • MCP hosts use miudb mcp serve --transport stdio.
  • Neovim uses normal .sql buffers through ui/miu-db.nvim.
  • Future UIs should sit under ui/ and call the core through the same command/protocol boundary.