diff --git a/README.md b/README.md
index 2cf2ee15cbc5094e56d4a7d0bda217b8220a0342..edbb8fb69d9164b8134edd296f5808dff42831a3 100644
--- a/README.md
+++ b/README.md
@@ -1,27 +1,33 @@
 # The CADET-Research Data Management toolbox
 
 ## Getting started
+
 ### Installation
+
 CADET-RDM can be installed using
 
 ```pip install cadet-rdm```
 
 ### Initialize Project Repository
+
 Create a new project repository or convert an existing repository into a CADET-RDM repo:
 
 ```bash
 cadet-rdm initialize-repo <path-to-repo>
 ```
+
 or from python
 
 ```python
 from cadetrdm import initialize_repo
+
 initialize_repo(path_to_repo)
 ```
 
 The `output_folder_name` can be given optionally. It defaults to `output`.
 
 ### Use CADET-RDM in Python
+
 #### Tracking Results
 
 ```python
@@ -47,14 +53,14 @@ if __name__ == '__main__':
         write_data_to_file(data, output_filepath)
 
         analysis_results = analyse_data(data)
-        figure_path=repo.output_data("analysis/regression.png")
+        figure_path = repo.output_data("analysis/regression.png")
         plot_analysis_results(analysis_results, figure_path)
 
 ```
 
 #### Sharing Results
 
-To share your project code and results with others, you need to create remote repositories on e.g. 
+To share your project code and results with others, you need to create remote repositories on e.g.
 [GitHub](https://github.com/) or GitLab. You need to create a remote for both the _project_ repo and the
 _results_ repo.
 
@@ -64,6 +70,7 @@ Once created, the remotes need to be added to the local repositories.
 cadet-rdm add-remote-to-repo <path_to_repo> git@<my_git_server.foo>:<project>.git
 cadet-rdm add-remote-to-repo <path_to_repo/output_folder> git@<my_git_server.foo>:<project>_output.git
 ```
+
 or in Python:
 
 ```python
@@ -72,7 +79,7 @@ repo.add_remote("git@<my_git_server.foo>:<project>.git")
 repo.output_repo.add_remote("git@<my_git_server.foo>:<project>_output.git")
 ```
 
-Once remotes are configured, you can push all changes to the project repo and the results repos with the 
+Once remotes are configured, you can push all changes to the project repo and the results repos with the
 command
 
 ```python
@@ -80,13 +87,12 @@ command
 repo.push()
 ```
 
-
 #### Re-using results from previous iterations
 
 Each result stored with CADET-RDM is given a unique branch name, formatted as:
 `<timestamp>_<output_folder>_"from"_<active_project_branch>_<project_repo_hash[:7]>`
 
-With this branch name, previously generated data can be loaded in as input data for 
+With this branch name, previously generated data can be loaded in as input data for
 further calculations.
 
 ```python
@@ -100,4 +106,30 @@ the correct branch name from the path to the file within the cache
 cached_array_path = repo.input_data(source_file_path="output_cached/<branch_name>/raw_data/data.csv")
 ```
 
+### Using results from another repository
+
+You can load in results from another repository to use in your project using the CLI:
+
+```bash
+cd path/to/your/project
+cadet-rdm import-remote-repo <URL> <branch_name>
+cadet-rdm import-remote-repo <URL> <branch_name> --target_repo_location <path/to/where/you/want/it>
+```
+
+This will store the URL, branch_name and location in the .cadet-rdm-cache.json file, like this:
 
+```json
+{
+  "__example/path/to/repo__": {
+    "source_repo_location": "git@jugit.fz-juelich.de:IBG-1/ModSim/cadet/agile_cadet_rdm_presentation_output.git",
+    "branch_name": "output_from_master_3910c84_2023-10-25_00-17-23",
+    "commit_hash": "6e3c26527999036e9490d2d86251258fe81d46dc"
+  }
+}
+```
+
+You can use this file to load the remote repositories based on the cache.json with
+
+```bash
+cadet-rdm fill_data_from_cadet_rdm_json
+```