finder-view
v0.1.0
Published
Control Finder window placement and sync it with your terminal directory on macOS.
Maintainers
Readme
finder-view
Control Finder window placement and optionally sync Finder with your terminal directory on macOS.
finder-view is a small CLI tool that helps keep Finder and your terminal aligned when navigating projects.

Install
npm install -g finder-viewCommands
Open Finder on the left side
finder leftOpen Finder on the right side
finder rightOpen Finder fullscreen
finder fullscreenOpen a specific folder
finder left ./srcor
finder right ~/DownloadsSync Finder with your terminal
You can make Finder automatically follow your terminal directory when using cd.
Install the sync hook:
finder syncReload your shell:
source ~/.zshrcor open a new terminal window.
Now Finder will update when you change directories.
Example:
cd project
cd src
cd componentsFinder will follow the current directory.
Remove Finder sync
To remove the shell integration:
finder unsyncThen reload your shell:
source ~/.zshrcBehavior
- Finder will only update if a Finder window already exists
- The tool will not open Finder automatically when using
cd - Finder windows can be placed left, right, or fullscreen
Requirements
- macOS
- Finder
- Node.js
This tool uses AppleScript to control Finder and therefore only works on macOS.
Example workflow
Open Finder next to your terminal:
finder leftNavigate your project:
cd src
cd componentsFinder will follow your current directory.
License
MIT License
Copyright (c) 2026 Jonatan Grön
