Skip to content

MorCherlf/SpotTerminal

Repository files navigation

SpotTerminal

CI Release Platform Swift Downloads License

SpotTerminal is a native macOS terminal tool featuring a Spotlight-style floating command panel. Summon it anytime with a hotkey to run quick commands, monitor background tasks from the menu bar, and expand into a full terminal when you need more room.

简体中文 | 繁體中文 | 日本語 | Русский

SpotTerminal hero

Highlights

  • Floating command panel with command suggestions and Tab completion.
  • Full terminal window with tabs, split panes, themes, opacity, and font zoom.
  • One-click expand from a quick command into an interactive terminal.
  • Menu bar task monitor for background commands.

Screenshots

Main Window
SpotTerminal main window
Run a Quick Command Floating Command Panel
Run a quick command Floating command panel
Running Sessions
Menu bar showing running sessions

System Requirements

  • macOS 14 Sonoma or later.
  • Apple Silicon and Intel Mac supported.

Installation

  1. Download the latest .dmg from GitHub Releases.
  2. Open the .dmg and drag SpotTerminal into Applications.
  3. Launch SpotTerminal.

SpotTerminal is currently not notarized by Apple. If macOS shows an "unidentified developer" warning:

  1. Open System Settings.
  2. Go to Privacy & Security.
  3. Find the blocked SpotTerminal message and click Open Anyway.
  4. Confirm Open when macOS asks again.

Build from Source

swift test
./script/build_and_run.sh --dmg

Security and Privacy

SpotTerminal runs commands locally on your Mac. It does not provide a network server, remote shell API, or external command-control interface.

No telemetry or data collection is included.

Diagnostics

SpotTerminal can write a local diagnostics log to help with bug reports. The log does not collect personal information or device identifiers.

You can open or clear diagnostics from Settings → Diagnostics.

Dependencies and Licenses

SpotTerminal is licensed under the Apache License 2.0. See LICENSE.

Third-party components and license notes are listed in THIRD_PARTY_NOTICES.md.

AI-Assisted Development

This project is developed with substantial AI assistance. If you find a bug, security issue, or unexpected behavior, please open an issue.

Feedback

Please report bugs through GitHub Issues.

About

A native macOS terminal app with a Spotlight-style floating quick command panel, triggered by shortcuts.

Topics

Resources

License

Stars

Watchers

Forks

Contributors