Skip to main content

​
tmux Workflow: From iTerm Chaos to Developer Productivity

My Rails development workflow had become a chaotic mess of terminal windows spread across multiple monitors. Here’s how switching to tmux transformed my development environment from cluttered chaos to organized productivity - including all the mistakes I made along the way.

​
The Multi-Monitor Dependency Problem

My Rails development workflow had grown into something that looked impressive but was actually a mess:
  • Monitor 1: All terminals (4 iTerm windows with 3 panes each)
  • Monitor 2: VS Code editors
  • Monitor 3: Browsers, mail, chat, and other apps
  • Total: 12 terminal panes crammed on one monitor
It looked like a command center from a sci-fi movie, but honestly? It was a mess. The limitations became apparent when I needed to work remotely. Any attempt to maintain productivity on a single laptop screen resulted in cramped terminal windows, constant application switching, lost context between tasks, and reduced overall efficiency. Your development environment should adapt to different working contexts, not dictate them. That’s when it hit me - I’d built a development setup that only worked in one very specific scenario. Take away my three monitors? I was screwed.

​
tmux Learning Curve: Common Beginner Mistakes to Avoid

Understanding tmux benefits doesn’t equal a smooth transition. I understood tmux’s theoretical benefits - terminal multiplexing, session persistence, and keyboard-driven efficiency. What I completely underestimated was how hard it would be to rewire my brain from pointing and clicking to memorizing keyboard shortcuts, all while trying to ship actual features. The first few days were… humbling. My most used command during the initial phase was Ctrl+B + ? (help menu) because everything else was foreign. The initial learning phase was dominated by constant reference lookups. I had to relearn fundamental operations: Navigation challenges included pane navigation without mouse interaction, window switching via keyboard shortcuts, and session identification beyond default numeric naming. Layout management meant learning window resizing without visual drag handles, pane splitting with keyboard commands, and maintaining spatial awareness of active panes. The challenge intensified due to ongoing project commitments. With multiple SaaS applications in active development, I couldn’t justify reduced productivity during the learning curve. This led to a counterproductive pattern:
  1. Attempt tmux in the morning
  2. Revert to iTerm when delivery pressure mounted
  3. Repeat daily without progress
This cycle prevented muscle memory development, extending the transition period unnecessarily. After I figured out how to create windows without constantly checking the manual, I hit what I call the “dangerous knowledge” phase - just enough familiarity to break things efficiently. You know that moment when you think you’ve got something figured out, but you really don’t? Yeah, that. Navigation and layout challenges were brutal. Going from clicking on things to remembering keyboard combinations was way harder than I thought. I kept accidentally closing panes when I meant to split them, and I had to actually think about which pane I was in instead of just looking at it. And don’t get me started on resizing panes. With iTerm, I could just click and adjust pane sizes. Now I had to type things like :resize-pane -L 10 and remember whether L meant left or… wait, what did L mean again? The configuration optimization trap nearly killed my progress. Like an idiot, I decided to tweak my configuration before I actually knew what I was doing - seeking shortcuts before mastering fundamentals. I found some tmux.conf file online that promised “sensible defaults and productivity improvements.” Spoiler alert: it didn’t work. The modified key bindings conflicted with developing muscle memory, I got advanced features without corresponding understanding, visual inconsistencies appeared across different sessions, and broken mouse integration made simple tasks harder. Don’t do this - trying to tweak tools before you understand how they work just makes everything harder, not easier. Session organization strategy was the one thing that worked immediately. The project-based window organization from my iTerm workflow actually translated perfectly to tmux sessions. Each project gets its own session - that way there’s no mixing of contexts or accidentally running commands in the wrong project. One session per project keeps everything clean and isolated. I can detach from one project session and attach to another without any cross-contamination between different codebases or environments. This approach just makes sense - you don’t want your blog project commands accidentally affecting your SaaS project, right?

​
When Things Finally Started to Click

It wasn’t like I had some big breakthrough moment. Instead, tmux slowly started making sense through smaller realizations about why this whole thing was actually useful. Session persistence and mobility was the game-changer. The breakthrough came when I experienced moving from desktop to laptop: I hit Ctrl+B + d to detach, then resumed work hours later via SSH with tmux attach. The complete state preservation included active Rails servers, streaming logs, open database consoles with pending queries, and all terminal history and context. That’s when I finally got it - I could just walk away from my computer and come back later without losing anything. No more “Oh crap, I have to restart all my servers and remember where I was.” My development environment could exist without me babysitting it. Context switching vs. parallel monitoring changed everything too. Instead of trying to watch everything at once, I started switching between different project sessions using the session browser (Ctrl+B + s). I could move between projects cleanly without any context mixing or keeping track of multiple screens at the same time. Here’s the weird part - having less visual information actually helped me focus more. My three-monitor setup was constantly distracting me with scrolling logs, notifications, and random stuff from other projects. With tmux, I could only see what I was actively working on. Turns out, trying to process information from three different monitors at once was actually making me dumber. With tmux forcing me to focus on one thing at a time, I could actually think clearly about the problem I was trying to solve. This was a wake-up call. My impressive-looking monitor setup might have been working against me the whole time. Sometimes less information is actually better for getting stuff done.

​
Rails Development tmux Setup: Production Workflow

The daily tmux workflow has become a practical system that works for real development constraints instead of theoretical ideals. Daily workflow is simple now. Work begins by reattaching to the persistent development environment: 
ssh desktop
tmux attach
The complete development state stays intact from the previous session - active Rails servers, log streams, database connections. No more startup overhead or trying to remember where I left off. Session organization follows one session per project, which keeps everything clean and isolated:
  • Project A session: All Rails development for this specific project - server, logs, console, git commands
  • Project B session: Completely separate environment for the second project
  • Side Project session: Independent session for experimental work
Each session has its own Docker environment, Rails server, and database connections. I can detach from one project and attach to another without any risk of accidentally running commands in the wrong codebase. Typical work session layout uses a 3-window setup for Rails development: My typical 3-window setup for Rails development:
  • Window 1: Development
  • Window 2: Services
  • Window 3: Infrastructure
docker compose up
Cross-device development continuity shows how powerful tmux really is. The daily workflow involves:
  1. Session detachment: Ctrl+B + d
  2. Remote reattachment: ssh desktop && tmux attach
  3. Continued work without environment reconstruction
  4. Reverse handoff for subsequent sessions
This completely frees your development environment from specific hardware. You can work from anywhere and pick up exactly where you left off.

​
Key Learnings and Trade-offs

Less information, better focus was the biggest revelation. More screens doesn’t equal more productivity. My old setup was constantly pulling my attention in different directions. tmux makes me focus on what I’m actually looking at. That said, there are times when you really do need to monitor multiple things at once - like when you’re debugging something complex. I’m still figuring out the right balance between deep focus and situational awareness. You don’t have to be a keyboard purist - this was a huge relief to discover. I initially thought “real” tmux users never touched the mouse. This was stupid. Enabling mouse support (set -g mouse on) actually makes sense for certain tasks. Sometimes clicking on a pane is just faster than trying to remember the keyboard shortcut, especially with complex layouts. The goal is to be productive, not to impress other developers. Ongoing proficiency development keeps me humble. Let me be honest: I probably use like 10% of tmux’s features. I still mess up commands, accidentally kill sessions, and have to look things up in the docs all the time. But here’s the thing - I don’t need to be a tmux master to get benefits from it. Once it stopped slowing me down and started making me faster, that was enough. You don’t need to know everything to improve your workflow. Configuration restraint strategy has been essential. I’ve learned that minimal configuration is better - minimal configuration beats complex optimization. My current .tmux.conf file has about 20 lines: 
# Enable mouse support
set -g mouse on

# Improve colors
set -g default-terminal "screen-256color"

# Sensible pane splitting
bind | split-window -h
bind - split-window -v

# Easier session switching
bind-key -n C-s choose-session
My early over-configuration mistakes keep me from adding unnecessary features. I evaluate each potential addition carefully now. Learning without breaking things became a hard rule. I’ve learned to explore new tmux features on weekends instead of in the middle of trying to ship something. Nothing worse than breaking your workflow when you’re on a deadline. Keeping the learning separate from actual work has been crucial. No more “let me try this cool new feature” at 2 PM on a Tuesday when I need to ship a feature the next morning. Adjacent technology exploration is tempting but dangerous. The tmux experience has made me interested in tiling window managers like i3 or Awesome WM. If terminal multiplexing works this well, maybe the same principles would work for my entire desktop. But my early configuration mistakes taught me to be careful about when and how I adopt new tools. You don’t want to break your workflow when you’re trying to ship features.

​
What I’d Do Differently If I Started Over

Looking back, there are definitely some things I’d do differently if I had to start this journey again. Start small - focus on basics first: creating windows (Ctrl+B + c), switching windows (Ctrl+B + n/p), splitting panes (Ctrl+B + ”, %), and detach/reattach (Ctrl+B + d). Everything else can wait until these become automatic. Automate early - use tmuxinator from day one. Being able to recreate your session layout automatically isn’t advanced - it’s essential. Don’t manually recreate the same pane layouts over and over. Plan learning time - accept temporary slowdown. Don’t try to learn tmux while being fully productive. That’s like learning stick shift during rush hour. Block out time and plan accordingly. tmux is now a core part of how I work on all my SaaS projects. Being able to quickly jump between different project environments without losing my place has been huge for my productivity. I can check on a project’s status, run some tests, make changes, and move on to the next project - all without the usual setup overhead. Each project gets the focus it deserves, and I don’t waste time reconstructing my development environment every time I switch contexts. Productivity gains I didn’t expect have been remarkable. My setup just works now - I don’t have to think about my development environment anymore. Instead of deciding “which terminals do I need open,” I focus on actually solving problems. Being able to cleanly detach from work sessions helps my work-life balance. No terminal windows staring at me all evening. I’ve reduced from three displays to two without losing productivity. tmux’s organization beats extra physical screen space. Future development directions remain cautious. I’m still exploring tmux capabilities, but my early configuration mistakes make me wary of adding complexity. Areas I’m investigating include custom key bindings for my workflow, scripts for automated session management, integration with other terminal tools (fzf, ripgrep), and plugin evaluation (with extreme caution). Big learning curve, but major long-term productivity gains. Mobility benefits provide seamless development environment access across devices that justifies the initial investment. Focus improvement through constraint-driven optimization enforces focus on contextually relevant data. tmux isn’t perfect, and I’m still learning new stuff all the time. But the productivity gains are so good that I can’t imagine going back to my old setup. The key is to learn a little at a time instead of trying to master everything at once. Even knowing the basics will make you way more productive. For Rails developers tired of juggling multiple terminal windows and wanting to be more productive, tmux is worth the learning curve. Requirements include patience during transition, structured learning approach, and commitment to consistent practice. Benefits include session persistence, cross-device development, better focus and less distraction, and improved terminal organization. Learn how to integrate AI services with Rails applications to improve your development workflow further.

​
Your Terminal Setup Probably Sucks Too

Sound familiar? 15 iTerm tabs spread across multiple desktops, or terminal windows you’re afraid to close because you’ll lose track of what’s running where. I get the hesitation about learning tmux. These are valid questions, and honestly, you won’t know until you try. Some people pick up tmux immediately and wonder why they waited so long. Others (like me) need a bit more time before it clicks. Both experiences are normal. The learning pattern is this: your current setup is holding you back, but switching to something better means being temporarily worse at your job. It’s annoying, but that’s how learning works.
⌘I