ambient-code/Ambient Action

Create sessions on the Ambient Code Platform from any GitHub workflow

Trust Signals

Scorecard Score: not yet scored
Maintenance Recency: Activelast commit Apr 3, 2026
License: Apache 2.0

Pinned Snippet

workflow.ymlSHA-pinned

uses: ambient-code/ambient-action@3f01516d00ba5628f210f9390a98970b5567c835 # v0.0.5

tags can be moved; commit SHAs can't. why a SHA?

Inputs

name	description	required	default
api-url	Ambient Code Platform backend API URL	yes	—
api-token	Bot user bearer token for the Ambient API	yes	—
project	Ambient project/namespace name	yes	—
prompt	Initial prompt for the session, or message to send to existing session	yes	—
session-name	Existing session name to send a message to (skips session creation)	no	""
display-name	Human-readable session display name	no	""
repos	JSON array of repos, e.g. [{"url": "...", "branch": "main", "autoPush": true}]	no	""
labels	JSON object of labels for the session	no	""
environment-variables	JSON object of environment variables to inject into the runner	no	""
timeout	Session inactivity timeout in seconds — auto-stops after this duration of inactivity	no	0
stop-on-run-finished	Stop the session automatically when the agent finishes its run	no	false
model	Model override (e.g. claude-sonnet-4-20250514)	no	""
workflow	JSON workflow object, e.g. {"gitUrl": "https://...", "branch": "main", "path": "workflows/my-wf"}	no	""
wait	Wait for session completion before exiting	no	false
poll-interval	Seconds between status polls when waiting	no	15
poll-timeout	Max minutes to poll before giving up when wait is true	no	60
no-verify-ssl	Disable SSL certificate verification (for self-signed certs)	no	false

Outputs

name	description
session-name	Created session name
session-uid	Created session UID
session-url	URL to the session in the Ambient UI
session-phase	Final session phase (only set when wait is true)
session-result	Session result text (only set when wait is true)