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
--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)
--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
--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
--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
--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
--interval	<INTERVAL>	no	5			Poll interval in seconds