explaingit

bunnysayzz/sideterminal

Analysis updated 2026-05-18

23SwiftAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A macOS menu bar app that hides a terminal along the edge of your screen, keeping sessions like SSH or long builds running while it's out of view.

Mindmap

mindmap
  root((repo))
    What it does
      Edge reveal terminal
      Keeps sessions alive
      Multiple session shelf
    Tech stack
      Swift
      AppKit and SwiftUI
      Apple Silicon macOS
    Use cases
      Instant terminal access
      Long running SSH or builds
      Script driven control
    Audience
      macOS developers
    Setup
      Download DMG
      Bypass Gatekeeper once
      macOS 14 plus required

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Keep a terminal instantly reachable by moving the mouse to a screen edge instead of switching windows or apps.

USE CASE 2

Run long-lived sessions like SSH connections, tmux, or Claude CLI that keep working while the terminal is hidden.

USE CASE 3

Switch between up to ten separate live terminal sessions from one sidebar.

USE CASE 4

Trigger show, hide, or toggle actions from your own scripts using the app's notification-based control channel.

What is it built with?

SwiftAppKitSwiftUImacOS

How does it compare?

bunnysayzz/sideterminalarinltte/ariashinno/wechat-multi
Stars232323
LanguageSwiftSwiftSwift
Setup difficultyeasymoderateeasy
Complexity2/52/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

The app is unsigned since it has no paid Apple Developer account, so macOS blocks it on first launch until you run a one-line command or approve it in System Settings.

MIT: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice. Includes some third-party components under their own licenses.

In plain English

SideTerminal is a macOS app that gives you a terminal window hidden along the edge of your screen. Move your mouse to that edge and the terminal slides into view, move away and it slides back out of sight. The important part is that hiding the terminal never stops what is running inside it, so long builds, remote SSH connections, or a Claude command line session keep going for hours even while the window is out of view. The app can hold up to ten separate terminal sessions at once, each with its own scrollback history and running programs, and you can switch between them instantly from a shelf. It is smart about not hiding itself while you are actively typing, selecting text, dragging, or scrolling. It lives in the menu bar rather than the Dock by default, keeping things uncluttered, and remembers your working folder across restarts. Settings cover general behavior, sidebar position, appearance, and more advanced options, and changes apply right away without needing a restart. You can record your own keyboard shortcut to show or hide the terminal, and the app will refuse a shortcut combination that is already taken by something else. To install, you download a disk image from the Releases page and drag the app into Applications. Because the app is open source and not signed with a paid Apple developer account, macOS will block it the first time you open it, and the README explains the one command needed to allow it, or the equivalent step in System Settings. It requires macOS 14 or later on Apple Silicon Macs. You can also build it yourself from source using the provided scripts, which requires Apple's Command Line Tools. The project is released under the MIT license and includes some third-party open-source components.

Copy-paste prompts

Prompt 1
Help me install SideTerminal from the Releases page and get past macOS Gatekeeper's block on unsigned apps.
Prompt 2
Show me how to build SideTerminal from source using its bootstrap and build scripts.
Prompt 3
Explain how to drive SideTerminal from a shell script using its DistributedNotificationCenter control channel.
Prompt 4
Walk me through setting a custom keyboard shortcut to toggle the sidebar terminal.
Prompt 5
How does SideTerminal keep sessions like SSH or Claude CLI alive while the terminal is hidden?

Frequently asked questions

What is sideterminal?

A macOS menu bar app that hides a terminal along the edge of your screen, keeping sessions like SSH or long builds running while it's out of view.

What language is sideterminal written in?

Mainly Swift. The stack also includes Swift, AppKit, SwiftUI.

What license does sideterminal use?

MIT: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice. Includes some third-party components under their own licenses.

How hard is sideterminal to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is sideterminal for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.