NAME

       gh-codespace-cp - Copy files between local and remote file systems

SYNOPSIS

       gh codespace cp [-e] [-r] [-- [<scp flags>...]] <sources>... <dest>

DESCRIPTION

       The cp command copies files between the local and remote file systems.

       As  with  the  UNIX  cp  command,  the  first  argument  specifies the source and the last
       specifies the destination; additional sources may be specified after  the  first,  if  the
       destination is a directory.

       The --recursive flag is required if any source is a directory.

       A  remote: prefix on any file name argument indicates that it refers to the file system of
       the remote (Codespace) machine. It is resolved relative  to  the  home  directory  of  the
       remote user.

       By default, remote file names are interpreted literally. With the --expand flag, each such
       argument is treated in the manner of scp, as a Bash expression  to  be  evaluated  on  the
       remote  machine, subject to expansion of tildes, braces, globs, environment variables, and
       backticks. For security, do not use this flag with arguments provided by untrusted  users;
       see ⟨https://lwn.net/Articles/835962/⟩ for discussion.

       By  default, the cp command will create a public/private ssh key pair to authenticate with
       the codespace inside the ~/.ssh directory.

OPTIONS

       -c, --codespace <string>
              Name of the codespace

       -e, --expand
              Expand remote file names on remote shell

       -p, --profile <string>
              Name of the SSH profile to use

       -r, --recursive
              Recursively copy directories

       -R, --repo <string>
              Filter codespace selection by repository name (user/repo)

       --repo-owner <string>
              Filter codespace selection by repository owner (username or org)

EXAMPLE

       $ gh codespace cp -e README.md 'remote:/workspaces/$RepositoryName/'
       $ gh codespace cp -e 'remote:~/*.go' ./gofiles/
       $ gh codespace cp -e 'remote:/workspaces/myproj/go.{mod,sum}' ./gofiles/
       $ gh codespace cp -e -- -F ~/.ssh/codespaces_config 'remote:~/*.go' ./gofiles/

SEE ALSO

       gh-codespace(1)

                                             Mar 2024                          GH-CODESPACE-CP(1)