Hyper Terminal is a modern, extensible terminal emulator for macOS that offers a rich plugin ecosystem and beautiful interface. While it's great for development work, one common challenge is integrating it with Finder like the native Terminal app. This guide will show you how to create a custom Quick Action in Automator to open Hyper Terminal from any folder in Finder.

## Prerequisites

Before you begin, ensure you have:
- macOS installed
- Hyper Terminal installed
- Basic familiarity with Automator

## Creating the Quick Action

1. Open Automator
2. Choose "Quick Action" as the type of document
3. Configure the Quick Action settings:
   - Workflow receives: "files or folders"
   - In: "Finder"
   - Image: Choose an icon (optional)

4. Add the following actions:
   - "Get Selected Finder Items"
   - "Run Shell Script"

5. In the shell script action, enter:
```bash
for f in "$@"
do
    cd "$f"
    /Applications/Hyper.app/Contents/MacOS/Hyper
done
```

{{< figure src="hyper-terminal-using-automator.png" alt="Hyper Terminal Quick Action in Automator" >}}

## Using the Quick Action

1. Right-click on any folder in Finder
2. Go to Quick Actions
3. Select your custom Hyper Terminal action

The terminal will open in the selected directory.

## Troubleshooting

### Common Issues

1. Quick Action Not Appearing
   - Ensure the Quick Action is saved
   - Check System Preferences > Extensions > Finder
   - Verify the action is enabled

2. Terminal Opens in Wrong Directory
   - Verify the shell script is correct
   - Check folder permissions
   - Ensure the path to Hyper.app is correct

3. Permission Issues
   - Check System Preferences > Security & Privacy
   - Grant necessary permissions to Automator
   - Verify Hyper Terminal permissions

## Alternative Methods

### Using Keyboard Shortcuts

1. Open System Preferences
2. Go to Keyboard > Shortcuts
3. Select Services
4. Find your Quick Action
5. Assign a keyboard shortcut

### Using Spotlight

1. Press Cmd + Space
2. Type the name of your Quick Action
3. Press Enter when selected

## Best Practices

1. Naming Convention
   - Use clear, descriptive names
   - Include "Hyper" in the action name
   - Add version number if needed

2. Organization
   - Group related Quick Actions
   - Use consistent naming
   - Keep actions focused and simple

3. Maintenance
   - Test after macOS updates
   - Verify paths are correct
   - Update as needed

## Further Reading

- [macOS Automator Guide]
- [Quick Actions User Guide]
- [Terminal Integration Tips]

[hyper]: https://hyper.is/
[iterm]: https://iterm2.com/
[macos automator guide]: https://support.apple.com/guide/automator/welcome/mac
[quick actions user guide]: https://support.apple.com/guide/mac-help/quick-actions-mchlp1400/mac
[terminal integration tips]: https://github.com/vercel/hyper/issues/2120