Skip to main content
The jasonisnthappy CLI provides a powerful command-line interface for interacting with jasonisnthappy databases. It supports both one-off commands and an interactive REPL mode.

Installation

The CLI is distributed as a binary executable:
curl -fsSL https://jasonisnthappy.sh/install.sh | sh

Basic usage

The CLI follows this general syntax:
jasonisnthappy [DATABASE] [OPTIONS] [COMMAND]

Quick examples

jasonisnthappy mydb.db db info

Global flags

These flags are available for all commands:
FlagShortDefaultDescription
--format-fprettyOutput format: json, table, or pretty
--interactive-ifalseStart interactive REPL mode
--web-ui-wfalseStart web UI server
--web-address127.0.0.1:8080Web UI server address
If you specify a database path without any command, the CLI automatically enters interactive mode.

Output formats

The CLI supports three output formats controlled by the --format flag:
Colorized, human-readable output (default)
jasonisnthappy mydb.db --format pretty doc find users
Found 2 documents:

Document ID: 1
{
  "name": "Alice",
  "age": 30
}

Document ID: 2
{
  "name": "Bob",
  "age": 25
}

Web UI mode

Launch a built-in web interface alongside the CLI:
jasonisnthappy mydb.db --web-ui
Customize the server address:
jasonisnthappy mydb.db --web-ui --web-address 0.0.0.0:3000
The web UI runs in the background and provides a visual dashboard for browsing collections, running queries, and viewing metrics.

Command categories

Commands are organized into logical groups:

Exit codes

The CLI uses standard exit codes:
CodeMeaning
0Success
1General error (invalid syntax, database error, etc.)
2Missing required argument

Next steps

Database commands

Backup, compact, and inspect your database

Document commands

Insert, query, and modify documents

Interactive REPL

Explore your database interactively

Collection commands

Manage collections and schemas

Build docs developers (and LLMs) love