@@ -38,6 +38,14 @@ inputs:
     description: "Base URL for OIDC token exchange API. Only required when running a custom GitHub App install. Defaults to https://api.opencode.ai"
     required: false
 
+  server_url:
+    description: "URL of a remote OpenCode server to connect to (e.g., https://agent.acme.com:4096). Enables remote execution on persistent servers."
+    required: false
+
+  server_password:
+    description: "Password for the remote OpenCode server (should be passed via GitHub secrets). Required if server_url is provided and server is password protected."
+    required: false
+
 runs:
   using: "composite"
   steps:
@@ -77,3 +85,5 @@ runs:
         MENTIONS: ${{ inputs.mentions }}
         VARIANT: ${{ inputs.variant }}
         OIDC_BASE_URL: ${{ inputs.oidc_base_url }}
+        SERVER_URL: ${{ inputs.server_url }}
+        SERVER_PASSWORD: ${{ inputs.server_password }}
@@ -228,6 +228,33 @@ try {
 process.exit(exitCode)
 
 function createOpencode() {
+  const serverUrl = useEnvServerUrl()
+  const serverPassword = useEnvServerPassword()
+
+  if (serverPassword && !serverUrl) {
+    throw new Error("server_password provided without server_url. Remote authentication requires a target host.")
+  }
+
+  if (serverUrl) {
+    const headers: Record<string, string> = {}
+    if (serverPassword) {
+      headers["Authorization"] = `Bearer ${serverPassword}`
+    }
+
+    const client = createOpencodeClient({
+      baseUrl: serverUrl,
+      headers: Object.keys(headers).length > 0 ? headers : undefined,
+    })
+
+    return {
+      server: {
+        url: serverUrl,
+        close: () => {},
+      },
+      client,
+    }
+  }
+
   const host = "127.0.0.1"
   const port = 4096
   const url = `http://${host}:${port}`
@@ -337,6 +364,14 @@ function useEnvMock() {
   }
 }
 
+function useEnvServerUrl() {
+  return process.env["SERVER_URL"] || undefined
+}
+
+function useEnvServerPassword() {
+  return process.env["SERVER_PASSWORD"] || undefined
+}
+
 function useEnvGithubToken() {
   return process.env["TOKEN"]
 }