adachsoft/command-runner-tool

AI tool-call SPI tool that runs interactive CLI commands via external HTTP API and manages command sessions.

v0.1.0 2026-02-04 17:31 UTC

Requires

• php: ^8.1
• adachsoft/ai-tool-call: ^2.0.1
• adachsoft/normalized-safe-path: ^0.1
• guzzlehttp/guzzle: ^7.10

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.89
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^12.4
• rector/rector: ^2.3.3

MIT

• Arkadiusz Adach

• http
• cli
• Guzzle
• command
• tools
• runner
• ai
• ai-tool-call

README

adachsoft/command-runner-tool is a PHP library that exposes the command_runner tool for the adachsoft/ai-tool-call ecosystem.

The tool acts as a thin SPI wrapper around an external HTTP API that runs interactive CLI commands and manages their sessions. It is designed to be used by AI agents and automation workflows via the ai-tool-call facade.

Key capabilities:

• start and kill interactive command sessions via HTTP,
• send input and fetch output for running sessions,
• list sessions and inspect basic session details,
• integrate with adachsoft/ai-tool-call using ToolInterface and ToolFactoryInterface.