100xMess CLI 🍽️

A simple terminal-based client for ordering food from your hostel mess. No apps, no browsers — just your terminal.

Prerequisites

• Node.js v18 or higher
• A Telegram account

Installation

1. Clone this repo

git clone https://github.com/iaman08/100xMess-CLI.git
cd 100xMess-CLI

2. Install dependencies

npm install

3. Link the mess command globally

npm link

You can now use mess from anywhere in your terminal.

Setup

4. Log in

mess login

• It will open a Telegram link in your browser.
• Start the bot, click "Get Token", and copy the token.
• Paste it back into the terminal.
• Your account will be sent for admin approval. Wait for the Telegram notification that says you're approved.

Commands

| Command | Description | |---|---| | mess menu | View today's full menu | | mess search <query> | Search for items by name | | mess order | Place a new order (interactive) | | mess status <orderId> | Check the status of an order | | mess orders | View your recent order history | | mess watch <orderId> | Live-watch an order's status updates | | mess cancel <orderId> | Cancel a pending order | | mess whoami | Show your current logged-in account | | mess logout | Log out and clear your session |

How Ordering Works

1. Run mess order and pick items from the menu.
2. Confirm your order — you'll get an Order ID.
3. Track it with mess status <orderId> or mess watch <orderId>.
4. When the order is Ready, the vendor will send a verification OTP to your Telegram.
5. Share the OTP with the vendor to collect your food. ✅

Troubleshooting

• mess login says "Not approved yet" — Wait for the admin to approve your account. You'll get a Telegram message.
• mess menu fails — Check your internet connection. The server might be restarting; try again in 30 seconds.
• Token errors — Run mess logout and then mess login again to refresh your session.