Procco (Process Commando) is a PHP agent that lets you trigger system commands from any input source. It is designed to be run on a schedule (e.g. via cron) and acts as a secure bridge between an input handler and the host system.
The input source is determined by the configured input handler. The built-in handler uses e-mail (IMAP), but any source can be supported by implementing a custom handler — a webhook listener, an SMS gateway, etc.
- PHP 8.4+
- PHP
imapextension (php -m | grep imap) - Linux host (only tested platform)
- Optional:
sudoprivileges for commands requiring elevated permissions
git clone https://github.com/Jammmmm/Procco.git
cd Procco
composer install
cp config.example.php /path/to/myconfig.php
# Edit myconfig.php with your settingsSee docs/USAGE.md for full configuration reference and usage instructions.
See docs/ARCHITECTURE.md for a component overview and guide to extending Procco with custom input and notification handlers.
See docs/ABOUT.md for the security model.
You are responsible for what you configure. Procco executes exactly what you define in your configuration. If you configure a command that deletes files, formats a disk, or otherwise damages your system, that is your own doing. Protections such as token validation, sender whitelisting, and process isolation are provided by default — but they only protect against unauthorized use, not misconfiguration. Review your command definitions carefully before deploying.
See CHANGELOG.md.
Licensed under the GNU General Public License v3.0.