{"id":29655819,"url":"https://github.com/prana-w/btw_cli","last_synced_at":"2026-04-15T22:35:37.532Z","repository":{"id":304372050,"uuid":"1016922464","full_name":"prana-W/btw_cli","owner":"prana-W","description":"btw_cli is a simple and powerful Command Line Interface (CLI) designed to help you perform various useful tasks directly from your terminal.","archived":false,"fork":false,"pushed_at":"2025-08-15T20:49:23.000Z","size":125,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-19T05:26:51.075Z","etag":null,"topics":["cli","productivity","terminal","tool"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@prana-w/btw","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/prana-W.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-09T18:28:32.000Z","updated_at":"2025-08-15T20:49:26.000Z","dependencies_parsed_at":"2025-07-12T18:32:47.051Z","dependency_job_id":"74b84b58-0185-4a0b-9d35-1f3374cc91ae","html_url":"https://github.com/prana-W/btw_cli","commit_stats":null,"previous_names":["prana-w/btw_cli"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/prana-W/btw_cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prana-W%2Fbtw_cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prana-W%2Fbtw_cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prana-W%2Fbtw_cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prana-W%2Fbtw_cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prana-W","download_url":"https://codeload.github.com/prana-W/btw_cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prana-W%2Fbtw_cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31863495,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","productivity","terminal","tool"],"created_at":"2025-07-22T08:06:56.895Z","updated_at":"2026-04-15T22:35:37.525Z","avatar_url":"https://github.com/prana-W.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# btw_cli\n\n`btw_cli` (btw: _by-the-W_) is a simple and powerful **Command Line Interface (CLI)** designed to help students of National Institute of Technology, Jamshedpur perform various useful tasks directly from your terminal like checking result, attendance, GitHub stats, adding events to Google Calendar, and managing work sessions.\n\nIt streamlines productivity with quick commands for time tracking, task scheduling, and result viewing — all accessible without leaving your terminal.\n\n---\n\n## ⚙️ Installation\n\n### 🚀 Quick Global Install (Recommended for Users)\n\nTo install `btw_cli` globally and use it from **anywhere** in your terminal:\n\n```bash\nnpm i -g @prana-w/btw\n```\n\nThat’s it. You’re ready to go!\n\n\u003e Run commands like `btw result \u003croll\u003e` or `btw add-event` right from your terminal.  \n\u003e 🔍 See [Available Commands](#-available-commands) for the full list.\n\n---\n\n### 🧪 Local Setup for Testing/Contributing (For Developers Only)\n\nIf you want to **experiment locally**, test features, or contribute to development — follow the detailed setup instructions below for **Windows** or **Linux** systems.\n\n---\n\n## 🔧 Installation and Setup Guide\n\n### Step 1: Download or Clone the Project\n\nChoose **one** of the following:\n\n#### 🔹 Option 1: Download Zip\n\n1. [Download the ZIP file](https://github.com/prana-W/btw_cli/releases/download/v1.0.0/btw_cli_v1.0.0.zip)\n2. Extract it to a location of your choice\n3. Open the extracted folder\n\n#### 🔹 Option 2: Clone via Git\n\n```bash\ngit clone https://github.com/prana-W/btw_cli.git\n```\n\n---\n\n### Step 2: Platform-Specific Setup\n\n#### 🪟 For Windows\n\n1. Go to the extracted/cloned `btw_cli` folder\n2. Simply **double-click** the file: `setup_windows.bat`\n\n\u003e ⚠️ In case of a warning saying “Windows protected your PC”, click **More info**, swipe left, then **Run Anyway**  \n\u003e ⏳ Setup might take several minutes — be patient!\n\n---\n\n#### 🐧 For Linux\n\n1. Open the extracted/cloned `btw_cli` folder in your terminal\n2. Run the following command:\n\n```bash\nnpm run setup\n```\n\n\u003e ⚠️ Tested only on Ubuntu  \n\u003e ⏳ Setup might take several minutes — be patient!\n\n---\n\n\u003e 💡 **Make sure you have Node.js (v20 or later) installed before running the setup**\n\n---\n\n## 🧰 How to Use\n\nOnce installed, you can run commands like:\n\n```bash\nbtw \u003ccommand\u003e\n```\n\n---\n\n## 🗂️ Available Commands\n\n| Command               | Alias(es)         | Description                                             |\n| --------------------- | ----------------- | ------------------------------------------------------- |\n| `time`                | `now`, `t`        | Displays the current time                               |\n| `start-session`       | `start`, `ss`     | Starts and tracks a focused work session                |\n| `end-session`         | `end`, `es`       | Ends the current session and shows the total duration   |\n| `session-history`     | `session-h`, `sh` | Shows the history of your last 5 work sessions          |\n| `result \u003croll\u003e`       | –                 | Displays your academic result based on your roll number |\n| `add-event`           | `calender`, `cal` | Adds an event to your Google Calendar                   |\n| `gh-stats \u003cusername\u003e` | `github`, `gh`    | Displays your GitHub Statistics                         |\n| `set-sap`             | `sap`             | Set SAP credentials for checking attendance             |\n| `attendance`          | `att`, `a`        | Displays attendance in a tabular format                 |\n\n---\n\n## 🛠️ Technology Used\n\n- `Commander`: For building the CLI interface\n- `Enquirer`: For interactive prompts\n- `Chalk`: For styling the terminal output\n- `Ora`: For showing loading spinners\n- `Puppeteer`: For web scraping (e.g., GitHub stats, attendance)\n- `Conf`: For storing various data like session history\n- `DayJS`: For date and time handling\n- `Open`: For opening URLs in the default browser\n- `Figlet`: For adding ASCII art to terminal output\n- `Gradient String`: For gradient-colored terminal output\n- `Cli Table3`: For tabular display in terminal\n\n---\n\n## 📦 Contributing\n\nWe welcome contributions to this CLI tool! Follow the steps below to get started:\n\n### 🛠️ Setup Instructions\n\n1. **Fork and Clone** this repository:\n\n```bash\ngit clone https://github.com/prana-W/btw_cli.git\ncd btw_cli\n```\n\n2. **Create a new branch**:\n\n```bash\ngit checkout -b your-feature-branch\n```\n\n3. **Install dependencies**:\n\n```bash\nnpm install\n```\n\n4. **Run setup script**:\n\n- On **Windows**:\n\n```bash\n./setup_windows.bat\n```\n\n- On **Linux/macOS**:\n\n```bash\nnpm run setup\n```\n\n---\n\n### ✨ What You Can Contribute\n\n- New features\n- Bug fixes\n- Code cleanup\n- Documentation improvements\n\nBefore starting major changes, it is **recommended to [open an issue](https://github.com/prana-W/btw_cli/issues)** and discuss your ideas first.\n\n---\n\n### ✅ Submitting a Pull Request\n\n1. Commit your changes:\n\n```bash\ngit add .\ngit commit -m \"Add: your feature/fix description\"\n```\n\n2. Push your branch:\n\n```bash\ngit push origin your-feature-branch\n```\n\n3. Open a **Pull Request** from your fork to the `main` branch of this repository.\n\n---\n\n## 🚧 Coming Up\n\n- Check class skip limit and classes required (like [Attendance Seeker](https://github.com/prana-W/Attendance-Seeker))\n- Save credentials like WiFi/email passwords securely via terminal with a master key\n- Display upcoming NIT Jamshedpur events like exams, fests, etc., in calendar\n\n---\n\n## 📄 License\n\nThis project is licensed under the [MIT License](LICENSE).  \n© 2025 Pranaw Kumar\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprana-w%2Fbtw_cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprana-w%2Fbtw_cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprana-w%2Fbtw_cli/lists"}