Skip to content

neo push

Push the current checkout, creating the repo if it doesn’t exist.

Shortcut for neo repo push that infers <owner>/<name> from the checkout: owner = your handle, name = the existing remote or the work-tree directory name. New repos are created private.

neo push [OPTIONS] [TARGET] [GIT_ARGS]...
Option Value Required Default Env Values Description
<TARGET> no Optional <owner>/<name> (or bare <name>). Inferred from the checkout when omitted
--remote <REMOTE> no Remote name to create/update. Defaults to origin, so plain git push works afterwards — unless this checkout’s origin belongs to a different repo (a GitHub one, typically), in which case neosource is written beside it and origin is left untouched. In a neosource worktree checkout the remote it re-uses may point at the LOCAL dev stack, not the real forge; check git remote -v if unsure
--visibility <VISIBILITY> no private public, internal, private Visibility applied ONLY when the repo doesn’t exist yet and must be created; has no effect on an already-existing repo’s visibility. Defaults to private — note that neo repo push spells the same flag with a public default
--runner no Run the CI this push triggers ON THIS MACHINE (ADR 0056 §5): an ephemeral actor-bound session runner registers before the push, claims the push’s jobs, streams their logs into this terminal, and exits when the runs finish. The hosted pool is the fallback if this machine dies mid-run
<GIT_ARGS> no Extra arguments forwarded to git push after the remote name. Defaults to HEAD:refs/heads/<branch> --follow-tags