From 62f57f7bb17d6b4f5c8de8b2d068164766a538b6 Mon Sep 17 00:00:00 2001
From: Theodor Vararu <theo@vararu.org>
Date: Thu, 18 Jul 2024 12:15:29 +0200
Subject: [PATCH] Document using overmind instead of foreman

`overmind` is better suited to dealing with `binding.pry` and other
development-related concerns.
---
 README.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/README.md b/README.md
index 1896e6430..48bfddb7e 100644
--- a/README.md
+++ b/README.md
@@ -156,6 +156,21 @@ $ bin/dev
 ...
 ```
 
+#### Debugging with `binding.pry`
+
+TTY echo can get mangled when using `binding.pry` in `bin/dev`. To work around
+this, you can run `rails s` directly if you're not working with any JS or CSS
+assets.
+
+Alternatively, you can install `tmux` and
+[`overmind`](https://github.com/DarthSim/overmind#connecting-to-a-process) which
+is compatible with our `Procfile.dev`:
+
+```bash
+$ overmind start -f Procfile.dev
+$ overmind connect web
+```
+
 ### Testing
 
 To run the Rails tests: