CLI Reference

A terminal UI for tracking everything about your home.

micasa#

A terminal UI for tracking everything about your home.

Usage#

micasa [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for micasa
`--print-path`	-	Print the resolved database path and exit
`-v`, `--version`	-	version for micasa

Subcommands#

micasa backup – Back up the database to a file
micasa config – Manage application configuration
micasa demo – Launch with sample data in an in-memory database
micasa mcp – Run MCP server for LLM client access
micasa pro – Manage micasa Pro sync
micasa query – Run a read-only SQL query
micasa show – Display data as text or JSON

micasa backup#

Back up the database to a file.

Usage#

micasa backup [destination] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for backup
`--source`	-	Source database path (default: standard location, honors MICASA_DB_PATH)

micasa config#

Manage application configuration.

Usage#

micasa config [filter] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for config

Subcommands#

micasa config edit – Open the config file in an editor
micasa config get – Query config values with a jq filter (default: identity)

micasa config edit#

Open the config file in an editor.

Usage#

micasa config edit [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for edit

micasa config get#

Query config values with a jq filter (default: identity).

Usage#

micasa config get [filter] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for get

micasa demo#

Launch with fictitious sample data. Without a path argument, uses an in-memory database.

Usage#

micasa demo [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for demo
`--seed-only`	-	Seed data and exit without launching the TUI
`--years`	`0`	Generate N years of simulated home ownership data

micasa mcp#

Start a Model Context Protocol server over stdio, exposing micasa data to LLM clients like Claude Desktop and Claude Code.

Usage#

micasa mcp [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for mcp

micasa pro#

Encrypted multi-device sync for your household data.

Typical workflow:

First device: micasa pro init
First device: micasa pro invite (prints a one-time code)
Second device: micasa pro join <code>
Either device: micasa pro sync (push and pull changes)

Examples#

  micasa pro init
  micasa pro invite
  micasa pro join 01JQ7X2K.abc123
  micasa pro sync
  micasa pro status

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for pro

Subcommands#

micasa pro conflicts – List sync ops that lost LWW conflict resolution
micasa pro devices – List devices
micasa pro init – Bootstrap: create household, generate keys, register device
micasa pro invite – Generate invite code, wait for joiner handshake
micasa pro join – Join household with invite code
micasa pro status – Show sync status
micasa pro storage – Show blob storage usage
micasa pro sync – Force immediate push+pull cycle

micasa pro conflicts#

List sync ops that lost LWW conflict resolution.

Usage#

micasa pro conflicts [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for conflicts

micasa pro devices#

List devices.

Usage#

micasa pro devices [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for devices

Subcommands#

micasa pro devices revoke – Revoke a device

micasa pro devices revoke#

Revoke a device.

Usage#

micasa pro devices revoke <device-id> [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for revoke

micasa pro init#

Bootstrap: create household, generate keys, register device.

Usage#

micasa pro init [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for init
`--relay-url`	`https://relay.micasa.dev`	Relay server URL (honors MICASA_RELAY_URL)

micasa pro invite#

Generate invite code, wait for joiner handshake.

Usage#

micasa pro invite [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for invite

micasa pro join#

Join household with invite code.

Usage#

micasa pro join <code> [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for join
`--relay-url`	`https://relay.micasa.dev`	Relay server URL (honors MICASA_RELAY_URL)

micasa pro status#

Show sync status.

Usage#

micasa pro status [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for status

micasa pro storage#

Show blob storage usage.

Usage#

micasa pro storage [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for storage

micasa pro sync#

Force immediate push+pull cycle.

Usage#

micasa pro sync [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for sync

micasa query#

Execute a validated SELECT query against the database. Only SELECT/WITH statements are allowed. Results are capped at 200 rows with a 10-second timeout.

Usage#

micasa query <sql> [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for query
`--json`	-	Output as JSON

micasa show#

Print entity data to stdout. Entities: house, projects, project-types, quotes, vendors, maintenance, maintenance-categories, service-log, appliances, incidents, documents, all.

Flags#

Flag	Default	Description
`--deleted`	-	Include soft-deleted rows
`-h`, `--help`	-	help for show
`--json`	-	Output as JSON

Subcommands#

micasa show all – Show all entities
micasa show appliances – Show appliances
micasa show documents – Show documents
micasa show house – Show house profile
micasa show incidents – Show incidents
micasa show maintenance – Show maintenance items
micasa show maintenance-categories – Show maintenance categories
micasa show project-types – Show project types
micasa show projects – Show projects
micasa show quotes – Show quotes
micasa show service-log – Show service log entries
micasa show vendors – Show vendors

micasa show all#

Show all entities.

Usage#

micasa show all [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for all

Inherited flags#

Flag	Default	Description
`--deleted`	-	Include soft-deleted rows
`--json`	-	Output as JSON

micasa show appliances#

Show appliances.

Usage#

micasa show appliances [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for appliances

Inherited flags#

Flag	Default	Description
`--deleted`	-	Include soft-deleted rows
`--json`	-	Output as JSON

micasa show documents#

Show documents.

Usage#

micasa show documents [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for documents

Inherited flags#

Flag	Default	Description
`--deleted`	-	Include soft-deleted rows
`--json`	-	Output as JSON

micasa show house#

Show house profile.

Usage#

micasa show house [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for house

Inherited flags#

Flag	Default	Description
`--deleted`	-	Include soft-deleted rows
`--json`	-	Output as JSON

micasa show incidents#

Show incidents.

Usage#

micasa show incidents [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for incidents

Inherited flags#

Flag	Default	Description
`--deleted`	-	Include soft-deleted rows
`--json`	-	Output as JSON

micasa show maintenance#

Show maintenance items.

Usage#

micasa show maintenance [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for maintenance

Inherited flags#

Flag	Default	Description
`--deleted`	-	Include soft-deleted rows
`--json`	-	Output as JSON

micasa show maintenance-categories#

Show maintenance categories.

Usage#

micasa show maintenance-categories [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for maintenance-categories

Inherited flags#

Flag	Default	Description
`--deleted`	-	Include soft-deleted rows
`--json`	-	Output as JSON

micasa show project-types#

Show project types.

Usage#

micasa show project-types [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for project-types

Inherited flags#

Flag	Default	Description
`--deleted`	-	Include soft-deleted rows
`--json`	-	Output as JSON

micasa show projects#

Show projects.

Usage#

micasa show projects [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for projects

Inherited flags#

Flag	Default	Description
`--deleted`	-	Include soft-deleted rows
`--json`	-	Output as JSON

micasa show quotes#

Show quotes.

Usage#

micasa show quotes [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for quotes

Inherited flags#

Flag	Default	Description
`--deleted`	-	Include soft-deleted rows
`--json`	-	Output as JSON

micasa show service-log#

Show service log entries.

Usage#

micasa show service-log [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for service-log

Inherited flags#

Flag	Default	Description
`--deleted`	-	Include soft-deleted rows
`--json`	-	Output as JSON

micasa show vendors#

Show vendors.

Usage#

micasa show vendors [database-path] [flags]

Flags#

Flag	Default	Description
`-h`, `--help`	-	help for vendors

Inherited flags#

Flag	Default	Description
`--deleted`	-	Include soft-deleted rows
`--json`	-	Output as JSON

CLI Reference

micasa#

Usage#

Flags#

Subcommands#

micasa backup#

Usage#

Flags#

See also#

micasa config#

Usage#

Flags#

Subcommands#

See also#

micasa config edit#

Usage#

Flags#

See also#

micasa config get#

Usage#

Flags#

See also#

micasa demo#

Usage#

Flags#

See also#

micasa mcp#

Usage#

Flags#

See also#

micasa pro#

Examples#

Flags#

Subcommands#

See also#

micasa pro conflicts#

Usage#

Flags#

See also#

micasa pro devices#

Usage#

Flags#

Subcommands#

See also#

micasa pro devices revoke#

Usage#

Flags#

See also#

micasa pro init#

Usage#

Flags#

See also#

micasa pro invite#

Usage#

Flags#

See also#

micasa pro join#

Usage#

Flags#

See also#

micasa pro status#

Usage#

Flags#

See also#

micasa pro storage#

Usage#

Flags#

See also#

micasa pro sync#

Usage#

Flags#

See also#

micasa query#

Usage#

Flags#

See also#

micasa show#

Flags#

Subcommands#

See also#