neo

neosource CLI

neo [OPTIONS] <COMMAND>

Global options

Option	Value	Required	Default	Env	Values	Description
--host	<HOST>	no		NEOSOURCE_API		Forge base URL. Defaults to the stored login’s host, else the compiled-in default

Commands

• neo auth — Sign in and manage forge credentials
• neo ssh — Manage SSH keys for git/jj over SSH
• neo run — Run a workflow file locally
• neo workflow — Inspect workflow files without running them
• neo version — Show the version, build provenance, and nixpkgs pin
• neo doctor — Check that this machine can run what neo asks of it
• neo completion — Print a shell completion script on stdout
• neo docs — Print CLI reference documentation as markdown
• neo runner — Manage this host as a self-hosted runner
• neo repo — Manage repositories
• neo token — Manage personal access tokens
• neo issue — Manage issues
• neo ticket — Manage team tickets
• neo pr — Manage pull requests
• neo actions — Dispatch and inspect CI runs on the server
• neo push — Push the current checkout, creating the repo if it doesn’t exist
• neo adopt — Take over a local checkout: create, push everything, become origin
• neo migrate — Adopt every git checkout under a directory — “move my projects here”

Topics

• Environment variables — Every environment variable neo reads, and what it changes.
• Configuration — Where the stored login lives and how the forge host is resolved.
• Exit codes — What 0, 1 and 2 mean, so a wrapper script can tell them apart.
• Authentication — Signing in, personal access tokens, and git credentials.
• Tickets and issues — The two tracks: team-scoped KEY-N planning and repo-scoped owner/repo#N intake.