1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
|
---
stage: Create
group: Source Code
info: "To determine the technical writer assigned to the Stage/Group associated with this page, see https://handbook.gitlab.com/handbook/product/ux/technical-writing/#assignments"
description: "Add, commit, and push a file to your Git repository using the command line."
---
# Add files to your branch
You can use Git to add files to a Git repository.
## Add files to a Git repository
To add a new file from the command line:
1. Open a terminal.
1. Change directories until you are in your project's folder.
```shell
cd my-project
```
1. Choose a Git branch to work in.
- To create a branch: `git checkout -b <branchname>`
- To switch to an existing branch: `git checkout <branchname>`
1. Copy the file you want to add into the directory where you want to add it.
1. Confirm that your file is in the directory:
- Windows: `dir`
- All other operating systems: `ls`
The filename should be displayed.
1. Check the status of the file:
```shell
git status
```
The filename should be in red. The file is in your file system, but Git isn't tracking it yet.
1. Tell Git to track the file:
```shell
git add <filename>
```
1. Check the status of the file again:
```shell
git status
```
The filename should be green. The file is tracked locally by Git, but
has not been [committed and pushed](commit.md).
## Add a file to the last commit
To add changes to a file to the last commit, instead of to a new commit:
```shell
git add <filename>
git commit --amend
```
Append `--no-edit` to the `commit` command if you do not want to edit the commit message.
## Related topics
- [Add file from the UI](../../user/project/repository/index.md#add-a-file-from-the-ui)
- [Add file from the Web IDE](../../user/project/repository/web_editor.md#upload-a-file)
- [Sign commits](../../user/project/repository/signed_commits/gpg.md)
|
