Add explicit debug boolean input to always enable debug logs

README.md

@@ -91,6 +91,27 @@ with:
   warp_api_key: ${{ secrets.WARP_API_KEY }}
 ```
 
+## Debug Logging
+
+By default, the action enables Oz debug logging (`--debug`) only when GitHub requests it — for
+example, when you
+[re-run a job with step debug logging enabled](https://docs.github.com/en/actions/managing-workflow-runs/enabling-debug-logging).
+Set the `debug` input to `true` to always enable debug logging, regardless of whether step debug
+logging is on:
+
+```yaml
+- name: Run Oz with debug logging
+  uses: warpdotdev/oz-agent-action@v1
+  with:
+    prompt: Review the code changes on this branch
+    debug: true
+    warp_api_key: ${{ secrets.WARP_API_KEY }}
+```
+
+When `debug: true`, Oz logs are emitted on stderr even if the workflow run was not started with step
+debug logging. When `debug` is `false` (the default), the existing behavior is preserved: debug
+logging activates only when GitHub's step-debug signal is on.
+
 ## Helpful Tips
 
 - Inject relevant context from the GitHub event and previous steps into your Oz prompt via

action.yml

@@ -69,6 +69,11 @@ inputs:
       local runs.'
     required: false
     default: 'false'
+  debug:
+    description:
+      "Always enable debug logging (`--debug`), independent of GitHub's step debug option."
+    required: false
+    default: 'false'
   oz_channel:
     description: Oz release channel to use
     required: true

dist/index.js

@@ -43566,6 +43566,7 @@ async function runAgent(options = {}) {
     }
     const cloud = getBooleanInput('cloud');
     const computerUse = getBooleanInput('computer_use');
+    const debug = getBooleanInput('debug');
     const args = ['agent', cloud ? 'run-cloud' : 'run'];
     const host = getInput('host');
     if (host) {
@@ -43654,8 +43655,10 @@ async function runAgent(options = {}) {
             }
         }
     }
-    // In debug mode, show Oz logs on stderr.
-    if (isDebug()) {
+    // Enable Oz debug logging when the explicit `debug` input is set, or when GitHub
+    // requests step-debug logging (e.g. re-run with step debug logging enabled).
+    // In debug mode, Oz logs are shown on stderr.
+    if (debug || isDebug()) {
         args.push('--debug');
     }
     let stdout = '';

src/index.test.ts

@@ -66,6 +66,7 @@ function setDefaultInputs(): void {
   coreInputs.set('oz_version', 'latest')
   coreInputs.set('cloud', 'false')
   coreInputs.set('computer_use', 'false')
+  coreInputs.set('debug', 'false')
   coreInputs.set('host', '')
   coreInputs.set('environment', '')
 }
@@ -414,6 +415,66 @@ describe('runAgent', () => {
     expect(callArgs).not.toContain('--sandboxed')
     expect(coreMocks.warning).not.toHaveBeenCalled()
   })
+
+  it('omits --debug when debug is false and GitHub step-debug is off', async () => {
+    coreInputs.set('debug', 'false')
+    coreMocks.isDebug.mockReturnValue(false)
+    execMocks.getExecOutput.mockResolvedValue({
+      exitCode: 0,
+      stdout: 'Run ID: local-run\n',
+      stderr: ''
+    })
+
+    await index.runAgent({ skipInstall: true })
+
+    const callArgs = execMocks.getExecOutput.mock.calls[0][1] as string[]
+    expect(callArgs).not.toContain('--debug')
+  })
+
+  it('adds --debug when the debug input is true even without GitHub step-debug', async () => {
+    coreInputs.set('debug', 'true')
+    coreMocks.isDebug.mockReturnValue(false)
+    execMocks.getExecOutput.mockResolvedValue({
+      exitCode: 0,
+      stdout: 'Run ID: local-run\n',
+      stderr: ''
+    })
+
+    await index.runAgent({ skipInstall: true })
+
+    const callArgs = execMocks.getExecOutput.mock.calls[0][1] as string[]
+    expect(callArgs).toContain('--debug')
+  })
+
+  it('still adds --debug from GitHub step-debug when the debug input is false', async () => {
+    coreInputs.set('debug', 'false')
+    coreMocks.isDebug.mockReturnValue(true)
+    execMocks.getExecOutput.mockResolvedValue({
+      exitCode: 0,
+      stdout: 'Run ID: local-run\n',
+      stderr: ''
+    })
+
+    await index.runAgent({ skipInstall: true })
+
+    const callArgs = execMocks.getExecOutput.mock.calls[0][1] as string[]
+    expect(callArgs).toContain('--debug')
+  })
+
+  it('adds --debug exactly once when both debug input and GitHub step-debug are on', async () => {
+    coreInputs.set('debug', 'true')
+    coreMocks.isDebug.mockReturnValue(true)
+    execMocks.getExecOutput.mockResolvedValue({
+      exitCode: 0,
+      stdout: 'Run ID: local-run\n',
+      stderr: ''
+    })
+
+    await index.runAgent({ skipInstall: true })
+
+    const callArgs = execMocks.getExecOutput.mock.calls[0][1] as string[]
+    expect(callArgs.filter((arg) => arg === '--debug')).toHaveLength(1)
+  })
 })
 
 describe('reportShutdown', () => {

src/index.ts

@@ -111,6 +111,7 @@ export async function runAgent(options: RunAgentOptions = {}): Promise<void> {
 
   const cloud = core.getBooleanInput('cloud')
   const computerUse = core.getBooleanInput('computer_use')
+  const debug = core.getBooleanInput('debug')
   const args = ['agent', cloud ? 'run-cloud' : 'run']
   const host = core.getInput('host')
   if (host) {
@@ -215,8 +216,10 @@ export async function runAgent(options: RunAgentOptions = {}): Promise<void> {
     }
   }
 
-  // In debug mode, show Oz logs on stderr.
-  if (core.isDebug()) {
+  // Enable Oz debug logging when the explicit `debug` input is set, or when GitHub
+  // requests step-debug logging (e.g. re-run with step debug logging enabled).
+  // In debug mode, Oz logs are shown on stderr.
+  if (debug || core.isDebug()) {
     args.push('--debug')
   }