Skip to content
miu-db

Headless database work for humans and agents.

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.

01

Daily Driver

SQLite, PostgreSQL, MySQL, Snowflake, BigQuery, and SSH tunnels.

02

Headless Core

Config, secrets, adapters, tunnels, workers, and result paging.

03

Agent Contract

Stable JSON envelopes, bounded query output, and redacted errors.

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.
  • 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.