@porosys/pss/README.md

Porosys Server Setup (pss): General-purpose server setup and automation tool (including Netdata management)

# pss (Porosys Server Setup)

A general-purpose server setup and automation tool, including Netdata management and alerting.

## Installation

### From npm (recommended)

You can install `pss` globally:

```sh
npm install -g @porosys/pss
```

### From source

Clone the repository and install dependencies:

```sh
git clone <your-repo-url>
cd pss
npm install
npm run build
```

You can then run the CLI with:

```sh
node dist/bin/pss.js <group> <command>
```

Or, for development:

```sh
npx ts-node bin/pss.ts <group> <command>
```

## Usage

```sh
pss <group> <command>
```

### Groups
- `netdata` — Netdata installation, configuration, and alert management

### Netdata Commands
- `install`      Install Netdata and setup monitoring
- `uninstall`    Uninstall Netdata
- `restart`      Restart Netdata
- `config`       Configure Netdata
- `add-alert`    Add or manage Netdata alerts

## Example

```sh
pss netdata install
pss netdata add-alert
```

## Features
- Netdata installation, configuration, and alert management
- Interactive CLI for adding and managing alerts
- Designed to be extensible for other server setup tasks in the future