A command-line interface for interacting with YNAB (You Need A Budget).

Full user documentation available here

• src/ynab_cli/: Main source code
• tests/: Unit and integration tests
• docs/: Documentation (built with MkDocs)

• Python 3.11+
• uv

Clone the repository:

$ git clone https://github.com/jeffsawatzky/ynab-cli.git
$ cd ynab-cli

Install dependencies with uv:

$ uv sync

With uv:

$ uv run ynab-cli --help

• Source code is in src/ynab_cli/.
• Use feature branches for new work.
• Follow PEP8 and use type hints where possible.

$ make lint

$ make test

Or directly with pytest:

uv run pytest

• Docs are in docs/ and built with MkDocs.
• To serve docs locally:

$ uv run mkdocs serve

1. Fork the repository
2. Create a feature branch (git checkout -b feature/your-feature)
3. Commit your changes. Commits should follow conventional commits. The repo is configured with commitizen
4. Push to your fork and open a pull request

Please include tests for new features and bug fixes.

See LICENSE.md