GitHub Action

import { Badge } from ‘@astrojs/starlight/components’;

The ambient-action GitHub Action (v0.0.2) creates Ambient Code Platform sessions directly from GitHub workflows. Use it to automate bug fixes on new issues, run code analysis on pull requests, or trigger any agent workflow from CI/CD.

Modes

• Fire-and-forget — Create a session and move on. The workflow does not wait for the session to finish.
• Wait-for-completion — Create a session and poll until it completes (or times out). Useful when subsequent steps depend on the agent’s output.

Inputs

Input	Required	Default	Description
api-url	Yes	—	Ambient Code Platform API URL
api-token	Yes	—	Bearer token for authentication (store as a GitHub secret)
project	Yes	—	Target workspace/project name
prompt	Yes	—	Task prompt for the agent
display-name	No	—	Human-readable session display name
repos	No	—	JSON array of repo objects ([{"url":"...","branch":"...","autoPush":true}])
labels	No	—	JSON object of labels for the session
environment-variables	No	—	JSON object of environment variables to inject into the runner
workflow	No	—	JSON workflow object (e.g., {"gitUrl":"https://...","branch":"main","path":"workflows/my-wf"})
model	No	—	Model override (e.g., claude-sonnet-4-20250514)
wait	No	false	Wait for session completion
timeout	No	30	Session timeout in minutes
poll-interval	No	15	Seconds between status checks (only when wait: true)
no-verify-ssl	No	false	Disable SSL certificate verification (for self-signed certs)

Outputs

Output	Description
session-name	Name of the created session
session-uid	UID of the created session
session-phase	Final session phase (only set when wait: true)
session-result	Session result text (only set when wait: true)

Quick start

Add the action to any GitHub Actions workflow:

name: Run ACP Session
on:
  issues:
    types: [opened]

jobs:
  triage:
    runs-on: ubuntu-latest
    steps:
      - uses: ambient-code/ambient-action@v0.0.2
        with:
          api-url: ${{ secrets.ACP_URL }}
          api-token: ${{ secrets.ACP_TOKEN }}
          project: my-team
          prompt: |
            Triage this issue and suggest a severity label:
            ${{ github.event.issue.title }}
            ${{ github.event.issue.body }}

Wait for completion

Set wait: true to block the workflow until the session finishes:

- uses: ambient-code/ambient-action@v0.0.2
  with:
    api-url: ${{ secrets.ACP_URL }}
    api-token: ${{ secrets.ACP_TOKEN }}
    project: my-team
    prompt: "Analyze the codebase for security vulnerabilities and report findings."
    wait: true
    timeout: 30

Multi-repo sessions

Pass a JSON array to clone multiple repositories into the session:

- uses: ambient-code/ambient-action@v0.0.2
  id: session
  with:
    api-url: ${{ secrets.ACP_URL }}
    api-token: ${{ secrets.ACP_TOKEN }}
    project: platform-team
    prompt: "Refactor shared types to use the new schema"
    repos: |
      [
        {"url": "https://github.com/org/frontend.git", "branch": "main", "autoPush": true},
        {"url": "https://github.com/org/backend.git", "branch": "main", "autoPush": true}
      ]
    workflow: |
      {"gitUrl": "https://github.com/org/workflows.git", "branch": "main", "path": "workflows/cross-repo-refactor"}
    wait: true
    timeout: 45

- run: echo "Session ${{ steps.session.outputs.session-name }} finished"