micasa

micasa

Your house is quietly plotting to break while you sleep -- and you're dreaming about redoing the kitchen. micasa tracks both from your terminal.

Single SQLite file. No cloud. No account. No subscriptions.

Features

• When did I last change the furnace filter? Maintenance schedules, auto-computed due dates, full service history.
• What if we finally did the backyard? Projects from napkin sketch to completion -- or graceful abandonment.
• How much would it actually cost to... Quotes side by side, vendor history, and the math you need to actually decide.
• Is the dishwasher still under warranty? Appliance tracking with purchase dates, warranty status, and maintenance history tied to each one.
• Who did we use last time? A vendor directory with contact info, quote history, and every job they've done for you.

Install

Requires Go 1.25+:

go install github.com/cpcloud/micasa/cmd/micasa@latest

Or grab a binary from the latest release.

micasa --demo         # poke around with sample data
micasa                # start fresh with your own house
micasa --print-path   # show where the database lives

One SQLite file. Your data, your machine. Back it up with cp.

Documentation

Full docs at micasa.dev/docs -- installation, user guide, keybinding reference, configuration, and development setup.

Development

Pure Go, zero CGO. Charmbracelet + GORM + SQLite. Pair-programmed with Claude via Cursor.

PRs welcome. The repo uses a Nix dev shell with pre-commit hooks for formatting, linting, and tests:

nix develop          # enter dev shell
go test ./...        # run tests

License

Apache-2.0 -- see LICENSE.