Manage Service Command

Manage Linux system services using the manage_service.py tool.

How This Command Works

This command orchestrates the system-admin skill's service management tool.

Architecture:

• The tool executes systemctl commands and returns structured output
• You read the tool's output to understand the result
• You DO NOT run systemctl directly - let the tool handle it

Workflow

1. Parse user request or $ARGUMENTS:

   • Action: start, stop, restart, status, enable, disable, is-active, is-enabled
   • Service name(s)
   • Options: --yes (skip confirmation), --logs, --dry-run

2. Invoke the manage_service.py tool:

   python3 ./skills/system-admin/scripts/manage_service.py <action> <service> [OPTIONS]
   

3. Read the output and report to user

Examples

Check service status:

User: /manage-service status nginx

Run: python3 ./skills/system-admin/scripts/manage_service.py status nginx
Report the service status from output

Restart a service:

User: /manage-service restart postgresql

Run: python3 ./skills/system-admin/scripts/manage_service.py restart postgresql --yes
Report success/failure

Enable at boot:

User: /manage-service enable docker

Run: python3 ./skills/system-admin/scripts/manage_service.py enable docker
Report that service is now enabled

Show status with logs:

User: /manage-service status nginx --logs

Run: python3 ./skills/system-admin/scripts/manage_service.py status nginx --logs --lines 30
Show status and recent log entries

Supported Actions

• start - Start a stopped service
• stop - Stop a running service
• restart - Restart a service
• status - Check service status
• enable - Enable service at boot
• disable - Disable service at boot
• is-active - Check if running (returns 0/1)
• is-enabled - Check if enabled (returns 0/1)

Important Reminders

• Use --yes to skip confirmation for stop/restart/disable
• Use --logs with status to see recent logs
• Use --dry-run to preview without executing
• Multiple services can be managed in one command