SUCA (slightly-useful-cli-apps) is a Python terminal application that bundles a few small utility tools into one interactive command-line interface. It runs as a loop where you type commands to access each tool.
- Python 3.12 or newer
No third-party packages are required. The app uses only the Python standard library (sqlite3, datetime, pathlib, math, random).
python main.py
Once running, type help to list available commands.
| Command | Description |
|---|---|
calc |
Opens the calculator |
note |
Opens the notes manager |
color |
Not yet implemented |
help |
Lists available commands |
exit |
Exits the application |
Supports basic arithmetic on integers.
calc
What operation?
+ - * /
Enter an operator, then provide two numbers when prompted. Supported operations: + (add), - (subtract), * (multiply), / (divide).
A simple note-taking system backed by a local SQLite database. Notes are stored at:
%USERPROFILE%\.suca\databases\notes.db (Windows)
~/.suca/databases/notes.db (Linux / macOS)
| Command | Description |
|---|---|
add |
Create a new note |
list |
List all notes (ID, title, date) |
view |
View a note by ID |
delete |
Delete a note by ID |
help |
Lists notes commands |
exit |
Return to the main menu |
Each note has a title, content, tags (comma-separated), and a creation timestamp.
Releases are built automatically via GitHub Actions using PyInstaller when a version tag (v*) is pushed. Binaries are produced for Windows, Linux, and macOS.
To build manually:
pip install pyinstaller
pyinstaller --onefile --clean --name suca main.pyThe output binary will be in the dist\ folder.
CC BY-NC 4.0 - Non-commercial use only.