cognesy/agent-ctrl

Unified CLI bridge for code agents (Claude Code, OpenAI Codex, OpenCode)

v2.0.0 2026-03-13 19:48 UTC

Requires

• php: ^8.3
• cognesy/instructor-events: ^2.0
• cognesy/instructor-sandbox: ^2.0
• cognesy/instructor-utils: ^2.0

Requires (Dev)

• pestphp/pest: ^2.34
• phpstan/phpstan: ^1.11
• roave/security-advisories: dev-latest

MIT

• Dariusz Debowczyk

README

Unified CLI bridge for code agents (Claude Code, OpenAI Codex, OpenCode) with one API and a normalized response type.

use Cognesy\AgentCtrl\AgentCtrl;
use Cognesy\AgentCtrl\Config\AgentCtrlConfig;

$response = AgentCtrl::codex()
    ->withConfig(new AgentCtrlConfig(
        timeout: 300,
        workingDirectory: getcwd() ?: null,
    ))
    ->execute('Summarize this repository.');

echo $response->text();