Petacomm Petacomm
Use Cases Support GitHub LinkedIn All Petacomm
petacomm.io › Server Tools › Petacomm Easy
AI-Powered · Claude API · v3.4

Server Management via
Natural Language

Describe what you want. Petacomm Easy handles the rest — no command memorization required. Every action shown before it runs. Every action logged and reversible.

Powered by AI — Claude API
Petacomm Easy uses Anthropic's Claude API to understand your intent and generate safe, auditable Linux commands. Every action is logged and reversible.
Quick Install — gbi.sh · repo.kotechsoft.com
$ curl -fsSL https://repo.kotechsoft.com/gbi.sh | sudo bash
Installation Guide Get API from Anthropic ›
#WorkSmarter #TakeItEasy #AIFirst
Petacomm Easy installs via gbi.sh — the script lives at repo.kotechsoft.com/gbi.sh See full install guide →
<3 minSetup Time
18+Distros Supported
0Dependencies
GPL‑3Open Source
What Is Petacomm Easy

Linux management
without the syntax.

Petacomm Easy is an AI-powered CLI tool that turns your natural language descriptions into real Linux commands. Instead of Googling every command or memorizing flags, you type what you mean — Easy figures out the rest.

Under the hood, Easy sends your request to Anthropic's Claude API, which generates the appropriate shell command. That command is shown to you before anything runs. You approve it, then Easy executes and logs the result.

Nothing ever runs without your confirmation. Every action is written to an append-only audit log. You can undo the last action at any time.

Powered by Claude API — You need an Anthropic API key to use Petacomm Easy. Get one free at platform.claude.com

How it works

1. You type petacomm -r "your request here"

2. Easy sends your request to Claude API

3. Claude generates the correct Linux command

4. Easy shows you the command and waits for y

5. Command runs. Result shown. Action logged.

What Easy does not do

Easy never runs a command without showing it to you first. It will not make irreversible changes silently. Destructive actions (removing files, dropping databases) always require explicit --yes or confirmation. You are always in control.

Live Examples

What can you ask?

Anything you would normally Google. Petacomm Easy covers everyday server tasks.

bash · disk management
# Find what is using disk space
$ petacomm -r "what's eating all my disk space?"
Easy → du -sh /* 2>/dev/null | sort -rh | head -15

# Clean up old log files
$ petacomm -r "delete log files older than 30 days in /var/log"
Easy → find /var/log -type f -name "*.log" -mtime +30 -delete

# Check disk usage per directory
$ petacomm -r "show disk usage of each directory in /home"
Easy → du -sh /home/* | sort -rh

# Preview — see command without running
$ petacomm -r "empty the /tmp directory" --dry-run
Easy → Would run: rm -rf /tmp/* [dry-run — no changes]
bash · process management
# Top memory consumers
$ petacomm -r "show top 10 memory-hungry processes"
Easy → ps aux --sort=-%mem | head -11

# Kill a stuck process
$ petacomm -r "kill the process using port 8080"
Easy → fuser -k 8080/tcp

# Restart service if it's down
$ petacomm -r "restart nginx if it's not running"
Easy → systemctl is-active nginx || systemctl start nginx

# Check what started recently
$ petacomm -r "list processes started in the last 5 minutes"
Easy → ps -eo pid,lstart,cmd --sort=start_time | awk ...
bash · networking
# List open ports
$ petacomm -r "show all open ports and which process owns them"
Easy → ss -tulnp

# Check connectivity
$ petacomm -r "is 8.8.8.8 reachable from this server?"
Easy → ping -c 3 8.8.8.8

# Current network traffic
$ petacomm -r "show live network bandwidth usage"
Easy → ifstat -i eth0 1 5

# DNS lookup
$ petacomm -r "what DNS servers is this machine using?"
Easy → cat /etc/resolv.conf | grep nameserver
bash · security
# Failed SSH logins
$ petacomm -r "show all failed SSH login attempts from the last hour"
Easy → journalctl -u sshd --since "1 hour ago" | grep "Failed password"

# Find world-writable files
$ petacomm -r "find any world-writable files in /etc"
Easy → find /etc -type f -perm -002 2>/dev/null

# Check sudo permissions
$ petacomm -r "which users have sudo access?"
Easy → grep -Po '^sudo.+:\K.*$' /etc/group

# Firewall status
$ petacomm -r "show current firewall rules"
Easy → iptables -L -n --line-numbers
bash · service management
# Service status
$ petacomm -r "show all failed services"
Easy → systemctl --failed

# Reload and verify
$ petacomm -r "reload nginx config and check if it's valid first"
Easy → nginx -t && systemctl reload nginx

# Set up cron job
$ petacomm -r "add a cron job to clear /tmp every night at 3am"
Easy → (crontab -l; echo "0 3 * * * rm -rf /tmp/*") | crontab -

# Service logs
$ petacomm -r "show last 50 lines of postgresql logs"
Easy → journalctl -u postgresql -n 50 --no-pager
bash · user management
# Who is logged in
$ petacomm -r "who is currently logged into this server?"
Easy → who

# Create user
$ petacomm -r "create a new user called deploy with sudo access"
Easy → useradd -m -s /bin/bash deploy && usermod -aG sudo deploy

# Password expiry
$ petacomm -r "which user accounts have passwords that never expire?"
Easy → awk -F: '($5==-1 || $5==99999){print $1}' /etc/shadow

# Lock an account
$ petacomm -r "lock the account of user john"
Easy → passwd -l john
Installation

Install Petacomm Easy
in under 3 minutes.

The installer script is named gbi.sh and is hosted at repo.kotechsoft.com/gbi.sh

1

Get a Claude API key

Petacomm Easy uses Anthropic's Claude API to understand natural language. You need a free API key before installation.

Get API Key — platform.claude.com
2

Run the installer — gbi.sh

The gbi.sh script auto-detects your Linux distribution, installs the correct package, and sets up the service. No manual package manager configuration required.

bash — recommended one-liner
# Download and run gbi.sh installer
$ curl -fsSL https://repo.kotechsoft.com/gbi.sh | sudo bash
Want to inspect the script before running it? Download and review it first: curl -fsSL https://repo.kotechsoft.com/gbi.sh -o gbi.sh && cat gbi.sh

The installer will print what it detects and what it installs. A typical run looks like this:

output
gbi.sh v1.4 · Petacomm Easy Installer
──────────────────────────────────────
✓ Distro detected : Ubuntu 24.04 LTS (Noble)
✓ Architecture : amd64
✓ Package manager : apt

→ Adding Petacomm repository...
✓ GPG key imported
✓ Repository added

→ Installing petacomm-easy...
✓ petacomm-easy 3.4.1 installed
✓ petacomm CLI available at /usr/bin/petacomm

Next step: run petacomm configure --api-key YOUR_KEY
3

Add your Claude API key

Configure your Anthropic API key. It is stored encrypted in the Petacomm keyring — never in plaintext.

bash
$ sudo petacomm configure --api-key sk-ant-xxxxxxxxxxxxxxxx
✓ API key saved to /etc/petacomm/keyring (encrypted)
Never commit your API key to source control. You can also set it as the environment variable PETACOMM_API_KEY instead of storing it in the keyring.
4

Start the service

bash
$ sudo petacomm start --enable-all
✓ petacomm-easy active and enabled on boot
✓ Web UI: http://localhost:7474
✓

Done — run your first command

bash
$ petacomm -r "show me the 5 biggest files on this server"
Easy → find / -type f -exec du -sh {} + 2>/dev/null | sort -rh | head -5
→ Execute? [y/N]: y
✓ Results shown. Action logged.

Alternative install methods

bash — Debian / Ubuntu
$ curl -fsSL https://apt.petacomm.io/gpg | sudo gpg --dearmor \
-o /usr/share/keyrings/petacomm.gpg
$ echo "deb [signed-by=...] https://apt.petacomm.io stable main" \
| sudo tee /etc/apt/sources.list.d/petacomm.list
$ sudo apt update && sudo apt install -y petacomm-easy
bash — Arch Linux
$ yay -S petacomm-easy
# or manually from AUR:
$ git clone https://aur.archlinux.org/petacomm-easy.git
$ cd petacomm-easy && makepkg -si
bash — RHEL / Fedora
$ sudo rpm --import https://rpm.petacomm.io/gpg
$ sudo dnf config-manager --add-repo https://rpm.petacomm.io/stable
$ sudo dnf install -y petacomm-easy
bash — standalone binary
# Download pre-built binary directly
$ wget https://releases.petacomm.io/v3.4.1/peta-linux-amd64
$ chmod +x peta-linux-amd64
$ sudo mv peta-linux-amd64 /usr/local/bin/peta
✓ petacomm CLI ready — no other files needed

Configuration reference

Config file: /etc/petacomm/easy.conf

Key Default Description
api_key — Your Anthropic Claude API key
model claude-sonnet-4-20250514 Claude model to use
confirm_before_exec true Show command and wait for y/N
block_destructive true Extra confirmation for risky commands
audit_log /var/log/petacomm/audit.log Where to write the audit log
max_tokens 1024 Max tokens for Claude response
Supported Distributions
Ubuntu Debian Arch Alpine RHEL Fedora openSUSE +11 more
CLI Reference

All flags and
commands.

Core command

usage
petacomm -r "your natural language request" [flags]
petacomm --run "your natural language request" [flags]

Flags

Flag Type Description
-r, --run string Natural language request to execute
-y, --yes bool Skip confirmation prompt — execute immediately
--dry-run bool Show generated command without executing
--undo bool Revert the last executed command
--history bool Show recent command history from audit log
--model string Override Claude model for this request
--no-log bool Skip audit log for this command
--json bool Output result as JSON (for scripting)

Other petacomm commands

Command Description
petacomm configure Set API key and configuration interactively
petacomm status Show service status and current config
petacomm start / stop Start or stop the Easy daemon
petacomm --history View recent commands from audit log
petacomm undo Revert the last executed command
petacomm update Update to the latest version
petacomm version Print installed version

Environment variables

Variable Description
PETACOMM_API_KEY Anthropic Claude API key (overrides keyring)
PETACOMM_MODEL Claude model override
PETACOMM_CONFIRM Set to false to skip confirmations
PETACOMM_LOG_DIR Override log directory path
Features

Everything you need
to manage Linux safely.

AI-powered, but always in your control.

Petacomm Easy is designed around one principle: you should always know what is about to happen to your server before it happens. AI generates the command. You decide whether to run it.

  • Natural language input — no syntax memorization required
  • Command preview — see the exact command before it runs
  • Full audit log — every action logged with timestamp, user and result
  • Instant undo — petacomm undo reverts the last action
  • Dry-run mode — --dry-run shows command without executing
  • Destructive action protection — extra confirmation for dangerous commands
  • Single binary — zero runtime dependencies
  • 18+ distros — auto-detected at install time via gbi.sh
  • Ansible & Terraform — IaC integration modules included
  • Air-gapped support — offline installation bundle available
Install Now Full Documentation ›
Natural Language
Type your request like you'd explain it to a colleague. No flags, no man pages.
Safe by Design
Every command shown before execution. Destructive actions require explicit confirmation.
Audit Log
Append-only structured log. Every command, approval, execution and result recorded.
Instant Undo
Run petacomm undo to revert the last command immediately.
18+ Distros
gbi.sh auto-detects your distribution. One command works everywhere.
Zero Dependencies
Single binary. No Docker, no Node.js, no Python runtime required.

Ready to take control of your Linux server?

Install Petacomm Easy in under 3 minutes. Free, open source, always will be.

Install Directly Read the Docs ›