Bokkoli is a peer-to-peer TCP messaging CLI application built with Go, the Bubbletea framework, and SQLite for message persistence. The name "Bokkoli" is a playful fusion of "broccoli" and "보끔" (boggeum), the Korean word for "mix," reflecting its nature as a blend of technologies.
This lightweight chat application enables real-time, direct peer-to-peer communication through a clean, terminal-based interface. Users can easily connect and exchange messages using the TCP protocol, while SQLite ensures that conversation history is safely stored locally.
-
**Go** for the backend and message handling.
-
**SQLite** for persistent local message storage.
-
**Bubbletea** for the UI framework to create a clean terminal interface.
Here’s a look at the design architecture:
- Fuzzy Matching
- Questions, Comments, and Suggestion Forum within the app
- Peer Authentication
- Handshake Protocol
- Message Integrity
- Checksums
- Digital Signatures
- Encryption and Security
- Data Encryption
- End-to-End Encryption
- Peer Status Monitoring
- Ping/Pong Mechanism
- Health Checks
- File/Content Sharing
- File Chunking
- File Integrity Checks
- Unit Testing for reliability and coverage
You can easily install and run the Bokkoli CLI app by downloading the appropriate pre-compiled executable from Github.
Follow the steps below to get started.
Go to the official release page of this app:
GitHub Releases - Bokkoli
On the releases page, you will see a list of available versions and their associated executable files. Choose the version you want to install and download the appropriate executable for your operating system:
-
For Windows:
Downloadbokkoli_windows.exe
(Click on the file to download.) -
For macOS:
Downloadbokkoli_mac
(Click on the file to download.) -
For Linux:
Downloadbokkoli_linux
(Click on the file to download.)
If you're using macOS or Linux, you may need to grant the downloaded file execute permissions before running it.
To do so, open a terminal and navigate to the folder where you downloaded the file. Then run the following command:
chmod +x bokkoli_mac # For macOS
chmod +x bokkoli_linux # For LinuxNow you can run the app from the terminal:
On Windows:
Simply double-click bokkoli_windows.exe to run the app.
Alternatively, you can open a command prompt and run:
./bokkoli_windows.exe # For Windows
./bokkoli_mac # For macOS
./bokkoli_linux # For Linux
A big thank you to Thomas for insights in problem-solving and improving the app's performance and functionality. :D

