cognesy / agent-ctrl

v2.10.1 2026-09-13 07:11 UTC

Requires

• php: ^8.3
• cognesy/instructor-config: ^2.10
• cognesy/instructor-events: ^2.10
• cognesy/instructor-sandbox: ^2.10
• cognesy/instructor-telemetry: ^2.10
• cognesy/instructor-utils: ^2.10
• cognesy/logging: ^2.3

Requires (Dev)

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

MIT

• Dariusz Debowczyk

Published on Packagist.org on 2026-09-13 07:36 UTC

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();

Execution Identity

Each execute() or executeStreaming() call gets its own internal executionId(). That id is the canonical correlation key for agent-ctrl events and telemetry.

sessionId() is different:

• executionId() is per run
• sessionId() is provider continuity metadata used for continueSession() and resumeSession()

That means multiple runs may share one sessionId() while still having different executionId() values.

$response = AgentCtrl::codex()->execute('Create a plan.');

echo (string) $response->executionId(); // one run
echo (string) ($response->sessionId() ?? ''); // provider session, if available