https://github.com/micasa-dev/micasa

A modal TUI for tracking home projects, maintenance schedules, appliances, and vendor quotes.
https://github.com/micasa-dev/micasa

Last synced: about 2 months ago
JSON representation

A modal TUI for tracking home projects, maintenance schedules, appliances, and vendor quotes.

• Host: GitHub
• URL: https://github.com/micasa-dev/micasa
• Owner: micasa-dev
• License: apache-2.0
• Created: 2026-02-06T20:44:30.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2026-04-20T11:59:07.000Z (about 2 months ago)
• Last Synced: 2026-04-20T13:43:36.543Z (about 2 months ago)
• Language: Go
• Homepage: https://micasa.dev
• Size: 115 MB
• Stars: 1,244
• Watchers: 2
• Forks: 50
• Open Issues: 50
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md
  • Agents: AGENTS.md

Awesome Lists containing this project

• awesome-github-repos - micasa-dev/micasa - A modal TUI for tracking home projects, maintenance schedules, appliances, and vendor quotes. (Go)

README

          




  


  



  [![CI](https://github.com/micasa-dev/micasa/actions/workflows/ci.yml/badge.svg)](https://github.com/micasa-dev/micasa/actions/workflows/ci.yml)

  [![Release](https://img.shields.io/github/v/release/micasa-dev/micasa)](https://github.com/micasa-dev/micasa/releases/latest)

  [![Go](https://img.shields.io/github/go-mod/go-version/micasa-dev/micasa)](https://go.dev)

  [![Docs](https://img.shields.io/badge/docs-micasa.dev-blue)](https://micasa.dev/docs)



# `micasa`

Home maintenance, from the terminal.



  



## Features

- **When did I last change the furnace filter?** Schedules, due dates, full history. Set it and forget it.

- **What if we finally did the backyard?** Projects from napkin sketch to completion, or graceful abandonment.

- **How much would it cost to…** Quotes side by side, vendor history, and the math to actually decide.

- **Who did we use last time?** Every contractor, every quote, every job. All searchable.

- **How much have I spent on plumbing this year?** Ask a local LLM. Or don't. Offline until you say otherwise.

## Keyboard driven

Vim-style modal keys: `nav` mode to browse, `edit` 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](https://micasa.dev/docs/reference/keybindings/).

## Install

```sh

go install github.com/micasa-dev/micasa/cmd/micasa@latest

```

Or grab a [binary](https://github.com/micasa-dev/micasa/releases/latest) for Linux, macOS, or Windows.

Then:

```sh

micasa demo         # sample data

micasa              # your house

```

## Documentation

Full docs at [micasa.dev/docs](https://micasa.dev/docs/).

## Development

[Pure Go](https://go.dev), zero CGO. Built on [Charmbracelet](https://github.com/charmbracelet) + [GORM](https://gorm.io) + [SQLite](https://sqlite.org). TUI design inspired by [VisiData](https://www.visidata.org/). Developed with AI coding agents ([Claude](https://claude.ai), [Claude Code](https://claude.ai/code)).

PRs welcome, including AI-assisted ones, as long as you've reviewed and curated the code. See the [contributing guide](https://micasa.dev/docs/development/contributing/).

```sh

nix develop                      # enter dev shell

go test -shuffle=on ./...        # run tests

```

## License

Apache-2.0. See [LICENSE](LICENSE).