Linux command
bagels 命令
文件
复制后可按需替换文件名、目录或参数。
常用示例
Start the application
bagels
Start with data stored
bagels --at [path/to/directory]
Locate the database
bagels locate database
Locate the configuration
bagels locate config
Migrate data
bagels --migrate actualbudget --source [path/to/source.db]
说明
bagels is a terminal user interface (TUI) application for tracking personal expenses and income. It stores all financial data locally in a SQLite database and presents an interactive interface built on the Textual framework. The application is organized into two main views: Home and Manager. The Home view displays transaction records, account balances, spending insights with graphs, income/expense mode toggles, and quick-access templates. The Manager view provides tools for configuring accounts, categories with subcategories, budgets, and people for split tracking. Key features include split transactions across multiple categories, transfers between tracked accounts and external accounts, recurring transaction templates accessible via number keys, and a jump mode system for keyboard-driven navigation between UI panels. The insights module provides spending analysis with visual graphs, estimated projections, and budget tracking against configurable limits. Bagels supports budgeting with configurable income assessment policies, savings percentage targets, and wants-versus-needs spending ratios. Records can be filtered by label, amount, category, and time period (day, week, month, or year). All data remains local on the user's machine, following XDG base directory conventions for file storage. The database and configuration can optionally be placed in a custom directory using the --at flag.
参数
- --at _path_
- Specify a custom directory for storing the database and configuration files. Defaults to XDG base directories.
- --migrate _type_
- Run a data migration from another application. Currently supports actualbudget.
- --source _path_
- Path to the source database file when using --migrate.
- locate config
- Display the path to the configuration YAML file.
- locate database
- Display the path to the SQLite database file.
FAQ
What is the bagels command used for?
bagels is a terminal user interface (TUI) application for tracking personal expenses and income. It stores all financial data locally in a SQLite database and presents an interactive interface built on the Textual framework. The application is organized into two main views: Home and Manager. The Home view displays transaction records, account balances, spending insights with graphs, income/expense mode toggles, and quick-access templates. The Manager view provides tools for configuring accounts, categories with subcategories, budgets, and people for split tracking. Key features include split transactions across multiple categories, transfers between tracked accounts and external accounts, recurring transaction templates accessible via number keys, and a jump mode system for keyboard-driven navigation between UI panels. The insights module provides spending analysis with visual graphs, estimated projections, and budget tracking against configurable limits. Bagels supports budgeting with configurable income assessment policies, savings percentage targets, and wants-versus-needs spending ratios. Records can be filtered by label, amount, category, and time period (day, week, month, or year). All data remains local on the user's machine, following XDG base directory conventions for file storage. The database and configuration can optionally be placed in a custom directory using the --at flag.
How do I run a basic bagels example?
Run `bagels` in a terminal, then adjust file names, paths, flags, or remote targets for your system.
What does --at _path_ do in bagels?
Specify a custom directory for storing the database and configuration files. Defaults to XDG base directories.