From ba8fa98c5708c9c5499f169340eed81f86d3de41 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 11 Sep 2025 20:18:25 +0000
Subject: [PATCH 1/2] Initial plan


From a454194d317a529719ad12b7768a013b252c9d45 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 11 Sep 2025 20:22:52 +0000
Subject: [PATCH 2/2] Add setup documentation to improve project startup
 experience

Co-authored-by: LilianMS <100161978+LilianMS@users.noreply.github.com>
---
 README.md | 48 ++++++++++++++++++++++++++++++++++++++++++------
 1 file changed, 42 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 0349dda..f7bc6b4 100644
--- a/README.md
+++ b/README.md
@@ -55,13 +55,31 @@ Built in collaboration: [@Letícia Sampietro](https://github.com/lesampietro) an
 
 ## 📂 How to Run
 
-### Clone the repository:
+### Prerequisites:
+Before building the project, make sure you have the readline library installed:
+
+**Ubuntu/Debian:**
+```bash
+sudo apt-get update
+sudo apt-get install libreadline-dev
+```
+
+**macOS:**
+```bash
+brew install readline
 ```
-bash
+
+### Clone and build:
+```bash
 git clone https://github.com/LilianMS/MiniShell.git
-cd minishell
+cd MiniShell
 make
 ```
+
+### Run the shell:
+```bash
+./minishell
+```
 ---
 <p align="right">
   <a href="#-minishell">🇺🇸</a> | <a href="#-minishell-em-português">🇧🇷</a>
@@ -116,10 +134,28 @@ Desenvolvido em colaboração: [@Letícia Sampietro](https://github.com/lesampie
 
 ## 📂 Como executar
 
-### Clonar o repositório:
+### Pré-requisitos:
+Antes de compilar o projeto, certifique-se de ter a biblioteca readline instalada:
+
+**Ubuntu/Debian:**
+```bash
+sudo apt-get update
+sudo apt-get install libreadline-dev
+```
+
+**macOS:**
+```bash
+brew install readline
 ```
-bash
+
+### Clonar e compilar:
+```bash
 git clone https://github.com/LilianMS/MiniShell.git
-cd minishell
+cd MiniShell
 make
 ```
+
+### Executar o shell:
+```bash
+./minishell
+```