https://github.com/bugwheels94/super-terminal
An advanced, cross platform, feature-rich terminal made with ❤️
https://github.com/bugwheels94/super-terminal
cross-platform css developer-experience electron javascript powershell react terminal terminal-emulator xtermjs
Last synced: 2 months ago
JSON representation
An advanced, cross platform, feature-rich terminal made with ❤️
- Host: GitHub
- URL: https://github.com/bugwheels94/super-terminal
- Owner: bugwheels94
- License: mit
- Created: 2022-05-24T13:31:44.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2024-08-20T08:08:31.000Z (almost 2 years ago)
- Last Synced: 2025-07-07T08:07:07.452Z (11 months ago)
- Topics: cross-platform, css, developer-experience, electron, javascript, powershell, react, terminal, terminal-emulator, xtermjs
- Language: TypeScript
- Homepage:
- Size: 9.2 MB
- Stars: 23
- Watchers: 3
- Forks: 3
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
Super Terminal
A terminal manager that remembers everything so you don't have to.
Restore terminals after reboot. Run multi-service projects with one click. Access from any machine over LAN.
---
## Features
- **Session restoration** — terminals, logs, and scroll position survive reboots
- **Project workspaces** — group related terminals together, launch everything with one click
- **Startup commands** — auto-run commands like `git config --user.name` when opening a project
- **Environment variables** — set once per project, never type them again
- **Clone terminals** — duplicate with same cwd, env vars, and settings
- **Themes** — apply any theme from [Windows Terminal Themes](https://windowsterminalthemes.dev/)
- **Multiline input** — double-click any terminal to enter multiline commands (curl, etc.)
- **Shell scripts** — save frequent commands and execute with a click
- **Auto-cleanup** — configurable max log size per project, auto-deletes old logs
- **LAN access** — run headless on a server, use from any browser on your network
- **Oh My Zsh compatible**
## Installation
### Desktop App
Available for **macOS** (Apple Silicon), **Linux**, and **Windows**.
| Method | Command |
|--------|---------|
| **Homebrew** (macOS) | `brew install bugwheels94/super-terminal/super-terminal --cask` |
| **Direct download** | [Latest Release](https://github.com/bugwheels94/super-terminal/releases/latest) |
macOS: "app is damaged" warning fix
```bash
sudo xattr -d com.apple.quarantine /Applications/Super\ Terminal.app
```
### Headless Server
For remote machines, servers, or running without a GUI.
| Method | Command |
|--------|---------|
| **Shell script** | `curl -fsSL https://raw.githubusercontent.com/bugwheels94/super-terminal/master/install.sh \| sh` |
| **Homebrew** | `brew install bugwheels94/super-terminal/super-terminal-headless` |
| **Direct download** | [Latest Release](https://github.com/bugwheels94/super-terminal/releases/latest) |
## Usage
**Desktop:** Launch Super Terminal from your Applications folder or start menu.
**Headless:**
```bash
super-terminal-headless
# Open http://localhost:3879 in your browser
```
## Configuration
Config file: **`~/.config/super-terminal/config`** (YAML)
```yaml
port: 3879
host: 127.0.0.1
```
Override via CLI flags or environment variables:
```bash
# CLI flags
super-terminal-headless --port 4000 --host 0.0.0.0
# Environment variables
SUPER_TERMINAL_PORT=4000 SUPER_TERMINAL_HOST=0.0.0.0 super-terminal-headless
```
## Development
```bash
npm install # Install dependencies
npm run tauri dev # Dev mode (Tauri + Vite)
npm run tauri build # Build desktop app
cargo build --release -p super-terminal # Build headless server
```
## License
MIT