git404hub

what is sideterminal fr?

bunnysayzz/sideterminal — explained in plain English

Analysis updated 2026-05-18

23SwiftAudience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

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.

vibe map

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 make with this?

VIBE 1

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

VIBE 2

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

VIBE 3

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

VIBE 4

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

what's the stack?

SwiftAppKitSwiftUImacOS

how it stacks up fr

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 i run it?

Difficulty · easy time til it works · 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.

prompts (copy fr)

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 fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.