Remote Sessions

Remote sessions let you access the same Copilot session from GitHub web and mobile via Mission Control. When enabled, the SDK connects the session to Mission Control and issues a URL that can be shared as a link or QR code. To run the session itself on GitHub-hosted infrastructure instead of locally or on your own server, use Cloud Sessions.

Prerequisites

The user must be authenticated (GitHub token or logged-in user)
The session’s workingDirectory must be a GitHub repository

Removed configuration options

Official SDK 1.0.26 removed the client remote option, the session remoteSession option, and the --remote CLI startup flag. To share a session, enable it on demand with $session->rpc()->remote()->enable(). The existing remote session RPCs continue to work.

On-demand (per-session toggle)

To share a session, toggle remote access via RPC. This is equivalent to the CLI’s /remote on and /remote off commands.

use Revolution\Copilot\Contracts\CopilotSession;
use Revolution\Copilot\Facades\Copilot;

Copilot::start(function (CopilotSession $session): void {
    $result = $session->rpc()->remote()->enable();

    if ($result->url !== null) {
        echo 'Remote URL: '.$result->url.PHP_EOL;
    }

    // Stop sharing
    $session->rpc()->remote()->disable();
});

Connect to an existing remote session (server-scoped)

To connect the CLI server to an existing remote session, call $client->rpc()->sessions()->connect(). Pass the remote sessionId in ConnectRemoteSessionParams. The result contains the SDK-side sessionId and the remote session’s metadata.

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\Rpc\ConnectRemoteSessionParams;

$client = Copilot::useTcp(url: 'tcp://127.0.0.1:12345')->client();

$connected = $client->rpc()->sessions()->connect(
    new ConnectRemoteSessionParams(sessionId: 'remote-session-id'),
);

echo $connected->sessionId;
// $connected->metadata - ConnectedRemoteSessionMetadata object

Runtime-wide Remote Control (TCP mode)

The remote property of RemoteControlConfig configures runtime-wide Remote Control. It is unrelated to the removed client remote startup option. In TCP mode, use $client->rpc()->sessions() to manage a single Remote Control for the whole runtime. Unlike the per-session remote()->enable(), these methods let you start, stop, and transfer Remote Control between sessions, and read its current status.

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\Rpc\RemoteControlConfig;
use Revolution\Copilot\Types\Rpc\SessionsStartRemoteControlRequest;

$client = Copilot::useTcp(url: 'tcp://127.0.0.1:12345')->client();

$result = $client->rpc()->sessions()->startRemoteControl(
    new SessionsStartRemoteControlRequest(
        sessionId: $sessionId,
        config: new RemoteControlConfig(
            remote: true,
            steerable: true,
            explicit: true,
            silent: false,
        ),
    ),
);

if ($result->status->frontendUrl !== null) {
    echo 'Remote URL: '.$result->status->frontendUrl.PHP_EOL;
}

The status is one of off, connecting, active, or error. When the status is active, you can also read frontendUrl and isSteerable.

$status = $client->rpc()->sessions()->getRemoteControlStatus();

$client->rpc()->sessions()->setRemoteControlSteering(['enabled' => true]);
$client->rpc()->sessions()->transferRemoteControl([
    'toSessionId' => $nextSessionId,
    'expectedFromSessionId' => $sessionId,
]);
$client->rpc()->sessions()->stopRemoteControl([
    'expectedSessionId' => $nextSessionId,
]);

To tell the runtime that a session’s remote steerability has changed, use the session-scoped RPC.

$session->rpc()->remote()->notifySteerableChanged(['remoteSteerable' => true]);

QR code generation

Render the remote URL as a QR code for easy mobile access. BaconQrCode, which is also used by Laravel Fortify, works well here.

use BaconQrCode\Renderer\Image\SvgImageBackEnd;
use BaconQrCode\Renderer\ImageRenderer;
use BaconQrCode\Renderer\RendererStyle\RendererStyle;
use BaconQrCode\Writer;

$writer = new Writer(
    new ImageRenderer(
        new RendererStyle(256),
        new SvgImageBackEnd(),
    ),
);

$svg = $writer->writeString($result->url ?? '');

Notes

If the working directory is not a GitHub repository, remote()->enable() may return an error.
Ensure authentication is configured correctly (github_token or use_logged_in_user).

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter Kits

Feeds and RSS

Middleware

Remote Sessions

Remote Sessions

Prerequisites

Removed configuration options

On-demand (per-session toggle)

Connect to an existing remote session (server-scoped)

Runtime-wide Remote Control (TCP mode)

QR code generation

Notes

See also

​Remote Sessions

​Prerequisites

​Removed configuration options

​On-demand (per-session toggle)

​Connect to an existing remote session (server-scoped)

​Runtime-wide Remote Control (TCP mode)

​QR code generation

​Notes

​See also

Remote Sessions

Prerequisites

Removed configuration options

On-demand (per-session toggle)

Connect to an existing remote session (server-scoped)

Runtime-wide Remote Control (TCP mode)

QR code generation

Notes

See also