> For the complete documentation index, see [llms.txt](https://apwt.gitbook.io/leerlijn-git/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apwt.gitbook.io/leerlijn-git/lokaal-werken/git-rm.md).

# git rm

{% hint style="success" %}
[Kennisclip](https://ap.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=0f6dbb0a-5ff6-4d8a-8202-ad9d00e19ca3) (sterk aangeraden dat je zelf de commando's toepast in een nieuwe testrepository)
{% endhint %}

## Betekenis

Via het commando `git rm` kan je een file verwijderen uit de working directory **en** noteer je dit meteen in de staging area. Dat laatste is belangrijk. Als je een file gewoon verwijdert, bijvoorbeeld door hem naar de prullenbak te verplaatsen, wordt hij beschouwd als "modified" en niet als "staged". En je kan een file die al verwijderd is wel stagen, maar het ziet er vreemd uit. Onderstaande demonstratie toont dit in een diagram. In de kolommen staan de verschillende onderdelen van een momentopname van je Git repository. De rijen stellen punten in de tijd voor, dus hoe verder naar beneden je gaat, hoe later de momentopname. Tussen de rijen staan acties die zorgen voor wijzigingen.

Je kan met de tools die je al kent een file verwijderen uit je working directory en uit versiebeheer als volgt:

![](/files/-Mj8MzGR4CoRxzF1yF9e)

Bij `git rm` wordt de file ook uit de working directory verwijderd en toont "changes to be committed" (via `git status`) dat de volgende commit de file niet meer zal bevatten (dus vanaf dan wordt hij weer untracked). Dan krijg je het volgende:

![](/files/-Mj8NIB5uk-o_dJL1dpD)

Je ziet dus dat er een tussenstap minder is tegenover wanneer je verwijdert en dan staget. Het standaardgebruik van `git rm` is dus vooral een snellere manier van werken.

Je kan ook `git rm --cached` gebruiken om het verwijderen van de file te stagen, zonder de file zelf te verwijderen. Dat kan nuttig zijn als je de file zelf wil bewaren, maar hem niet meer in versiebeheer wil opvolgen. Hij wordt dan terug untracked en je kan hem eventueel toevoegen aan `.gitignore`.

Dat kan je het volgende opleveren:

![](/files/-Mj8NVpey5eT_LOiLZW2)

Als je een van deze commando's op een map wil toepassen in plaats van op een gewone file, moet je `-r` toevoegen

| commando             | omschrijving                                                                                                    |
| -------------------- | --------------------------------------------------------------------------------------------------------------- |
| `git rm`             | verwijder een file en stage de verwijdering van deze file                                                       |
| `git rm -r`          | verwijder een volledige map en stage de verwijdering van deze map                                               |
| `git rm --cached`    | laat de file staan, maar stage toch de verwijdering van deze file (waardoor hij terug untracked zal worden)     |
| `git rm -r --cached` | laat de map staan, maar stage toch de verwijdering van deze map (waardoor de inhoud terug untracked zal worden) |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apwt.gitbook.io/leerlijn-git/lokaal-werken/git-rm.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
