🫘 Beans: tui bookkeeping

Beans is an accounting tui for individuals and small businesses, inspired by gnucash. It is designed to be simple and easy to use, but nonetheless powerful and flexible.

Beans is not feature-complete. Features may be added if one of the following conditions is met:

• I need it
• You need it and make a PR (See Contributing below)
• You need it and ask nicely

📦 Installation

• From source: cargo build --release
• From cargo: cargo install beans
• From the AUR: yay -S beans
• Homebrew: coming soon

📚 Usage

Detailed docs have not been written yet, so you'll have to figure it out yourself. Run beans to start the tui, default file name is ./beans.book. Refer to the bottom of the screen for keybinds, use ? to toggle the keybind list.

All functional keybinds are listed, but some conveniences are hidden. You'll discover them as you go.

Contributing

This project is hosted on private infrastructure, so there is no clear way to accept contributions. If you are truly interested in contributing, find my contact at betalupi.com and we'll figure something out.

Want a feature, found a bug? Willing to help fix it? Great!
Contributions are welcome, see LICENSE.

🤖 Clanker policy: Beans is not a vibe-coded mess, and will never become one. A human is be responsible for all code we ship.

Code generation is not prohibited, but thorough review is expected. Architectural and design decisions must always be made by a human that understands the project's goals and structure.

Documentation should be written carefully, not generated as an afterthought. Respect your audience.