Rahul R. Jagtap

📅 timesheet-cli - Track Time Effortlessly from Your Terminal

🏷️ Overview

The timesheet-cli is the official command-line interface for timesheet.io. This tool allows you to manage your timer, projects, tasks, and reports all from your terminal. Whether you’re a freelancer or part of a bigger team, you can efficiently track your time and boost your productivity.

🚀 Getting Started

To use timesheet-cli, follow these simple steps to get it up and running on your machine. You don’t need any technical expertise; just basic computer skills will do.

📥 Download & Install

Visit the Releases Page: Click on the link below to go to the Releases page where you can find the latest version of timesheet-cli.

Download the latest version here
Choose Your File: You will see different versions available for download. Select the one that matches your operating system:
- For Windows, download timesheet-cli-windows.zip.
- For macOS, download timesheet-cli-macos.zip.
- For Linux, download timesheet-cli-linux.tar.gz.
Unzip or Extract the File: After downloading the appropriate file, extract it to a folder on your computer. You can usually do this by right-clicking on the file and selecting “Extract All” or “Unzip.”
Open Your Terminal: Launch your command line interface:
- For Windows, search for Command Prompt or PowerShell.
- For macOS, open Terminal from your Applications folder.
- For Linux, open your preferred terminal emulator.
Navigate to the Folder: Use the cd command to change to the directory where you extracted the files. For example, if you placed it in a folder called “timesheet-cli” on your desktop, type:
```
cd ~/Desktop/timesheet-cli
```
Run the Application: To start using timesheet-cli, type the following command in your terminal:
```
./timesheet-cli
```
If you’re on Windows, use:
```
timesheet-cli.exe
```

🎛️ Features

Time Tracking: Easily start and stop timers for different tasks.
Project Management: Organize your work by projects.
Task Management: Add tasks to your projects and keep track of their statuses.
Reporting: Generate reports to review your time logs and productivity.

📄 Basic Commands

Here are a few basic commands to get you started:

To start a timer:
```
timesheet-cli start "Task Name"
```
To stop a timer:
```
timesheet-cli stop
```
To list all your recorded tasks:
```
timesheet-cli list
```
To generate a report:
```
timesheet-cli report
```

📅 System Requirements

Operating System:
- Windows 10 or later
- macOS 10.12 or later
- Any Linux distribution with Node.js installed
Software Requirements:
- Node.js version 14 or later. You can download it from nodejs.org.

🌟 Support

For any issues, consider checking the open and closed issues on our GitHub page. If you need further assistance, feel free to create a new issue describing your problem.

📜 License

This project is licensed under the MIT License, which allows you to use, modify, and distribute the software.

By following these steps, you should have a smooth experience using timesheet-cli. Happy tracking!