cpcloud / micasa

Your house is quietly plotting to break while you sleep -- and you're dreaming about redoing the kitchen. 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 -- all in your local currency with locale-correct formatting. • **Is the dishwasher still under warranty?** Appliance tracking with purchase dates, warranty status, and maintenance history tied to each one. • **The basement is leaking again.** Log incidents with severity and location, link them to appliances and vendors, and resolve them when fixed. • **Who did we use last time?** A vendor directory with contact info, quote history, and every job they've done for you. • **Where's the warranty card?** Attach files (manuals, invoices, photos) directly to projects and appliances. Stored as BLOBs in the same SQLite file -- backs up everything. Full-text search ( ) finds documents by title, notes, or extracted text. When an LLM is configured, PDFs and images are automatically processed through an extraction pipeline (text extraction, OCR, LLM) that pre-fills form fields with structured data. • **How much have I spent on plumbing?** Press to chat with a local LLM about your data. It writes the SQL, runs the query, and summarizes the results -- all on your machine. Keyboard driven Vim-style modal keys: mode to browse, mode to change things. Sort by any column, jump to columns with fuzzy search, hide what you don't need, and drill into related records. See the full keybinding reference. Local LLM chat Ask questions about your home data in plain English. micasa connects to a local Ollama server (or any OpenAI-compatible API) and translates your question into SQL, executes it, and summarizes the results. The model has access to your schema and actual database values, so it can handle fuzzy references like "plumbing stuff" or "planned projects." Toggle to see the generated SQL, or for mag mode that replaces money amounts with their order of magnitude. See the LLM chat guide and configuration reference for setup. Install Homebrew (macOS and Linux): Or with Go (1.25+): Or grab a binary from the latest release. Linux, macOS, and Windows binaries are available for amd64 and arm64. > One SQLite file. Your data, your machine. Back it up with . Need Nix or container install options? See the full installation guide. Documentation Full docs at micasa.dev/docs -- start with Installation and First Run, then use the Guide and Reference. Development Pure Go, zero CGO. Built on Charmbracelet + GORM + SQLite. TUI design inspired by VisiData -- modal navigation, column-level operations, and keyboard-driven data exploration. Developed with AI coding agents (Claude, Claude Code). PRs welcome -- including AI-assisted ones, as long as you've reviewed and curated the code. See the contributing guide for details. The repo uses a Nix dev shell with pre-commit hooks for formatting, linting, and tests: License Apache-2.0 -- see LICENSE.