DOT-Files/Gentoo/gentooamd/home/user/.tldrc/tldr/pages/common/nix-run.md

# nix run

> Run an application from a Nix flake.
> See also: `nix flake`.
> More information: <https://nix.dev/manual/nix/stable/command-ref/new-cli/nix3-run.html>.

- Run the default application in the flake in the current directory:

`nix run`

- Run a command whose name matches the package name from nixpkgs (if you want a different command from that package, see `tldr nix shell`):

`nix run nixpkgs#{{pkg}}`

- Run a command with provided arguments:

`nix run nixpkgs#{{vim}} -- {{path/to/file}}`

- Run from a remote repository:

`nix run {{remote_name}}:{{owner}}/{{repository}}`

- Run from a remote repository using a specific tag, revision, or branch:

`nix run {{remote_name}}:{{owner}}/{{repository}}/{{reference}}`

- Run from a remote repository specifying a subdirectory and a program:

`nix run "{{remote_name}}:{{owner}}/{{repository}}?dir={{dir_name}}#{{app}}"`

- Run the flake of a GitHub pull request:

`nix run github:{{owner}}/{{repository}}/pull/{{number}}/head`