Metadata-Version: 2.4
Name: linux-command
Version: 0.3.2
Summary: A command line tool to perform custom tasks.
Home-page: https://github.com/MouxiaoHuang/linux-command
Author: Mouxiao Huang
Author-email: huangmouxiao@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python
Dynamic: summary


# linux-command

[![CI](https://github.com/MouxiaoHuang/linux-command/actions/workflows/ci.yml/badge.svg)](https://github.com/MouxiaoHuang/linux-command/actions/workflows/ci.yml)
[![PyPI](https://img.shields.io/pypi/v/linux-command)](https://pypi.org/project/linux-command/)
[![GitHub stars](https://img.shields.io/github/stars/MouxiaoHuang/linux-command)](https://github.com/MouxiaoHuang/linux-command/stargazers)

`linux-command` provides a single `cmd` entrypoint for common Linux tasks. It keeps commands short, consistent, and easy to remember.

## Why linux-command

Linux commands are powerful but easy to forget, especially for archives and process checks. `linux-command` lowers the mental load with a unified syntax that reads like the task itself. For example, `cmd tar <source> <output.tar>` means “pack `<source>` into `<output.tar>`,” no long flags to recall.

## Installation

To install the package, run the following command:

```bash
pip install linux-command
```

## Install From Source (Development)

If you want to develop or modify the tool locally:

```bash
git clone https://github.com/MouxiaoHuang/linux-command.git
cd linux-command
pip install -e .
```

## Usage

Once installed, run commands with `cmd <command> [args...]`.

- `cmd -h` / `cmd --help` lists all available commands.
- `cmd <command> -h` shows usage and examples for a specific command.

Quick examples:

```bash
cmd tar ./src out.tar.gz
cmd untar archive.tar.gz ./out
cmd ps-grep python
```

Before vs cmd:

```
tar -czvf out.tar.gz ./src        ->  cmd tar ./src out.tar.gz
tar -xzvf archive.tar.gz -C ./out ->  cmd untar archive.tar.gz ./out
ps aux | grep python              ->  cmd ps-grep python
```

Full command list, examples, and aliases live in [`USAGE.md`](USAGE.md).

## Contributing

We welcome contributions from the community! If you'd like to help improve `linux-command`, feel free to report issues or submit pull requests.

### Guidelines for Contributors

- Follow the existing coding style where possible.
- Make sure your changes do not break existing functionality.
- Before submitting a major feature, it’s often a good idea to first discuss it by opening an issue.

### Thank you!

Thank you for your interest in contributing to `linux-command`! Your contributions are greatly appreciated and help make this tool better for everyone. For any questions or to get started, feel free to reach out or open an issue.

---

## License

This project is licensed under the MIT License.
