/ radicle-cli / examples / rad-rm.md
rad-rm.md
 1  To delete a repository from local storage, we use the `rad rm` command.
 2  First let's look at what we have locally:
 3  
 4  ```
 5  $ rad ls
 6  ╭───────────────────────────────────────────────────────────────────────────────────────────────────────────╮
 7  │ Name        RID                                 Visibility   Head      Description                        │
 8  ├───────────────────────────────────────────────────────────────────────────────────────────────────────────┤
 9  │ heartwood   rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji   public       f2de534   Radicle Heartwood Protocol & Stack │
10  ╰───────────────────────────────────────────────────────────────────────────────────────────────────────────╯
11  ```
12  
13  Now let's delete the `heartwood` project:
14  
15  ```
16  $ rad rm rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji --no-confirm
17  ✓ Untracked rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji
18  ✓ Successfully removed 'rad' remote
19  ✓ Successfully removed rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji from storage
20  ```
21  
22  We can check our repositories again to see if it was deleted:
23  
24  ```
25  $ rad ls
26  ```
27  
28  Attempting to remove a repository that doesn't exist gives us an error message:
29  
30  ``` (fail)
31  $ rad rm rad:z2Jk1mNqyX7AjT4K83jJW9vQoHn4f
32  ✗ Error: repository rad:z2Jk1mNqyX7AjT4K83jJW9vQoHn4f was not found
33  ```