Setting up a macbook for a windows developer

Published on March 25, 2018 - Tagged: #developer-experience

Follow me on twitter for more posts like this

I recently got a macbook at work and I’m doing only web development these days so no Visual Studio. I had to do a bit of reading to get things set up and I don’t want to do it again so here is a post for me!

UPDATE 3/1/2022: I’ve since created scripts to do all of this and more. You can find those here:

First thing is download iTerm from:

Open a new iTerm and run the following to install Homebrew (this is like chocolatey)

/usr/bin/ruby -e "$(curl -fsSL"

next install oh my zsh

sh -c "$(curl -fsSL"

Follow this great tutorial on setting up powershopp fonts and zsh:

Setup git with homebrew

brew update && brew upgrade

brew install git

brew link --force git

Install beyond compare from Open beyond compare and go to File >> Installl command line tools Confirm that “bcompare” can be launched from Terminal.

Run the fllowing lines to set up some git diff and merge magic and to add an alias to for code review (change develop here to whatever you use as your master branch)

Then in an iterm window enter:

git config --global alias.code-review = "!git difftool --dir-diff origin/develop...$1"
git config --global diff.tool bc3
git config --global difftool.bc3.trustExitCode true
git config --global merge.tool bc3
git config --global mergetool.bc3.trustExitCode true

Run a code review on some branch with differences and open the rules by clicking the rules button in the merge window o beyond compare. In here set beyond compare to follow symlinks! This will make all the paths line up like they should.

To launch a 3-way merge using Beyond Compare, use the command “git mergetool file.ext”. To launch a diff using Beyond Compare, use the command “git difftool —dir-diff”.

If you’re on a mac and you’re using Rider from jetbrains but the rest of your team is using visual studio you can have repository specifc ignores by editing the .git/info/exclude file. The following will hide the idea folder.


Set iterm to use your project directory as the start up location in the preferences for iterm

If you use jira I highly recommend the zsh plugin “jira”. To have this remember your jira instance add the following to ~/.zshrc

export JIRA_URL=
export JIRA_NAME=doriordan
export JIRA_RAPID_BOARD=true

then you can use

jira            # performs the default action
jira new        # opens a new issue
jira dashboard  # opens your JIRA dashboard
jira reported [username]  # queries for issues reported by a user
jira assigned [username]  # queries for issues assigned to a user
jira branch     # opens an existing issue matching the current branch name
jira ABC-123    # opens an existing issue
jira ABC-123 m  # opens an existing issue for adding a comment

Sweet, all done. This could be a great scripting project :D

Next install the following apps - Licecap for gif recording - window management for osx - an enhanced spotlight/helper

You can use to change the default applications on the mac. For example the mail client can be changed from Mail without having to setup an email account in Mail.

Photo by Fabian Grohs on Unsplash

Darragh ORiordan

Hi! I'm Darragh ORiordan.

I live and work in Sydney, Australia building supporting happy teams that create high quality software for the web.

I also make tools for busy developers! Do you have a new M1 Mac to setup? Have you ever spent a week getting your dev environment just right?

My DevShell tooling will save you 30+ hours configuring your dev environment with all the best modern tools. Get it here

Read more articles like this one...

List of article summaries


How to use SSH with Git and ssh-agent on Windows

I needed to run git natively in windows (no wsl) for a recent project. I use ssh certificates to authenticate with my git provider and it was difficult to get it all working as expected.

I didn’t want to use Git for Windows because it uses GitBash. I couldn’t use WSL because I wanted git to work on any terminal in windows. I also have pass phrases on all my ssh certificates so I needed ssh agent to avoid typing the passphrases all the time.

These are the steps I had to research to use Git on Windows with ssh-agent.


How to fix custom type definitions not being type checked

If you have a custom types file (e.g. myTypes.d.ts) but you get no errors from the type checker and compiler in typescript even though you know there are issues in the file you might have skipLibCheck turned on.


Consistent modern shell tooling on MacOS and Windows WSL for developers

I regularly code on both MacOS and Windows machines and I was always annoyed how different the default experiences are on each. I need to use the same tools and the same experience on both.

Windows “WSL” (Windows Subsystem for Linux) is a great tool for this you can use on Windows 10 and newer. The latest version lets you run a full Ubuntu instance that integrates seamlessly with the underlying windows instance.

By using WSL2 you can have a (mostly) identical developer experience jumping between MacOS and Windows.

Better tooling for Developers

Many of the terminal tools that come with unix environments are functionally similar to how they were 20 years ago. But other developer tooling has advanced quite a bit since then.

You can replace tools like ls or cat with modern equivalents that support full colour, unicode icons, git state and more. Terminal prompts can be made git aware and use colour to indicate state so you don’t have to query git so often.

Keeping developer experience consistent across machines

Keeping any shell changes you make on one machine up to date on all the machines you code on is a nightmare without the right tooling.

This article also explains all the tools I use and how I keep the same terminal setup consistent on MacOS and Windows!

Let’s go!


How engineers can help deliver software effectively

Delivery managers and team leads have the responsibility to deliver a software system via an engineering team.

Your customer wants every feature to work perfectly and they want it delivered yesterday. Your team wants to learn and grow.

It’s a tough role managing all the stakeholders and creators in a project.

Engineers can help drive great delivery by empathising with and supporting the delivery manager or leads in a project team.