neo actions

Dispatch and inspect CI runs on the server.

Dispatch, list, view, tail logs, approve, re-run, and watch runs. (Not neo run, which executes a workflow file locally on this machine; neo actions operates the server-side run records.)

neo actions [OPTIONS] <COMMAND>

neo actions resolve-workflow

Resolve a workflow selector to its registered, immutable identity

neo actions resolve-workflow [OPTIONS] <WORKFLOW> [TARGET]

Option	Value	Required	Default	Env	Values	Description
<WORKFLOW>		yes				Workflow id, exact repo-relative path, or exact declared name
<TARGET>		no				<owner>/<repo> or bare <repo>; inferred from the checkout when omitted
--json		no				Print the registered WorkflowResponse as JSON

neo actions run

Dispatch a workflow on an exact branch and wait for it to finish

neo actions run [OPTIONS] --ref <REFERENCE> <WORKFLOW> [TARGET]

Option	Value	Required	Default	Env	Values	Description
<WORKFLOW>		yes				Workflow id, exact repo-relative path, or exact declared name
<TARGET>		no				<owner>/<repo> or bare <repo>; inferred from the checkout when omitted
--ref	<REFERENCE>	yes				Branch to resolve and pin on the server
--expected-commit	<EXPECTED_COMMIT>	no				Reject the dispatch unless the branch resolves to this exact 40-hex commit
--input	<KEY=VALUE>	no				Set a workflow_dispatch input; repeat per input. Values are sent as strings and coerced by the server to the input’s declared type (boolean / number / choice)
--no-wait		no				Return as soon as the run is enqueued
--timeout	<TIMEOUT>	no	3600			Maximum seconds to wait
--interval	<INTERVAL>	no	5			Poll interval in seconds
--json		no				Print the enqueued or final run as JSON

neo actions list

List a repo’s workflow runs, newest first

neo actions list [OPTIONS] [TARGET]

Option	Value	Required	Default	Env	Values	Description
<TARGET>		no				<owner>/<repo> or bare <repo>. Inferred from a checkout remote pointing at this host when omitted
--status	<STATUS>	no			pending_approval, queued, quota_blocked, running, succeeded, failed, cancelled	Only runs with this status
--trigger-commit	<TRIGGER_COMMIT>	no				Only runs triggered by this exact 40-hex Git commit
--workflow-id	<WORKFLOW_ID>	no				Only runs registered under this full workflow UUID
--cursor	<CURSOR>	no				Opaque pagination cursor returned as next_cursor by --json
--limit	<LIMIT>	no	30			Page size (the server clamps to 100)
--json		no				Print the raw response as JSON

neo actions view

Show one run: header plus its jobs and their steps

neo actions view [OPTIONS] <RUN>

Option	Value	Required	Default	Env	Values	Description
<RUN>		yes				A full run id (UUID, dashed or undashed), a pasted run URL (https://…/<owner>/<repo>/actions/runs/<id>; its host overrides --host), or — resolved against your checkout’s repo — the short forms neo actions list prints: an id prefix (e.g. 019f3478) or a run number (#51, or deploy#51 when a bare number is ambiguous across workflows). A run number names every attempt of that run and resolves to the latest one; see --attempt
--attempt	<ATTEMPT>	no				With a run number, pick this attempt instead of the latest (re-runs keep the run number and count attempts from 1)
--json		no				Print {run, jobs} as JSON

neo actions logs

Print the logs of a run’s jobs (all jobs, or one via --job)

neo actions logs [OPTIONS] <RUN>

Option	Value	Required	Default	Env	Values	Description
<RUN>		yes				Run id or pasted run URL — see neo actions view --help
--attempt	<ATTEMPT>	no				With a run number, pick this attempt instead of the latest
--job	<JOB>	no				Only this job, by its key (name) or job id
--json		no				Print [{job_id, job_key, status, log}] as JSON

neo actions approve

Approve a run held pending_approval (an untrusted fork PR).

Its jobs then become claimable. Requires write access on the repo.

neo actions approve [OPTIONS] <RUN>

Option	Value	Required	Default	Env	Values	Description
<RUN>		yes				Run id or pasted run URL — see neo actions view --help
--attempt	<ATTEMPT>	no				With a run number, pick this attempt instead of the latest
--json		no				Print the raw response as JSON

neo actions rerun

Re-run a finished run (succeeded/failed/cancelled).

Enqueues a fresh attempt that keeps the run number and pins the same workflow snapshot, cause, and trigger commit. Requires write access on the repo. Refused (409) while the source run is still active.

neo actions rerun [OPTIONS] <RUN>

Option	Value	Required	Default	Env	Values	Description
<RUN>		yes				Run id or pasted run URL — see neo actions view --help
--attempt	<ATTEMPT>	no				With a run number, pick this attempt instead of the latest
--failed		no				Re-run only the failed jobs: carry every job that succeeded (and whose needs: all succeeded too) into the new attempt with its outputs and artifacts, and re-execute the rest. Refused (409) when the run has no failed or cancelled job
--json		no				Print the raw response as JSON

neo actions watch

Poll a run until it finishes, printing status transitions.

Exits 0 when the run succeeds, nonzero when it fails or is cancelled.

neo actions watch [OPTIONS] <RUN>

Option	Value	Required	Default	Env	Values	Description
<RUN>		yes				Run id or pasted run URL — see neo actions view --help
--attempt	<ATTEMPT>	no				With a run number, pick this attempt instead of the latest
--interval	<INTERVAL>	no	5			Poll interval in seconds