Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
 James Maes
|
cba76e22cf | ||
|
James Maes
|
990711e7c7 | ||
 james.maes
|
abb6e4e97f |
No files matched your search
@@ -158,28 +158,22 @@ jobs:
|
||||
|
||||
depends_on "tmux"
|
||||
|
||||
on_macos do
|
||||
on_arm do
|
||||
url "https://github.com/KofTwentyTwo/limen/releases/download/v#{version}/limen-macos-arm64"
|
||||
sha256 "${SHA_MACOS_ARM64}"
|
||||
end
|
||||
host_cpu = RbConfig::CONFIG.fetch("host_cpu", "")
|
||||
macos_arm = OS.mac? && (Hardware::CPU.arm? || host_cpu == "arm64" || RUBY_PLATFORM.start_with?("arm64-darwin"))
|
||||
linux_arm = OS.linux? && (Hardware::CPU.arm? || host_cpu == "aarch64" || host_cpu == "arm64")
|
||||
|
||||
on_intel do
|
||||
url "https://github.com/KofTwentyTwo/limen/releases/download/v#{version}/limen-macos-amd64"
|
||||
sha256 "${SHA_MACOS_AMD64}"
|
||||
end
|
||||
end
|
||||
|
||||
on_linux do
|
||||
on_arm do
|
||||
url "https://github.com/KofTwentyTwo/limen/releases/download/v#{version}/limen-linux-arm64"
|
||||
sha256 "${SHA_LINUX_ARM64}"
|
||||
end
|
||||
|
||||
on_intel do
|
||||
url "https://github.com/KofTwentyTwo/limen/releases/download/v#{version}/limen-linux-amd64"
|
||||
sha256 "${SHA_LINUX_AMD64}"
|
||||
end
|
||||
if macos_arm
|
||||
url "https://github.com/KofTwentyTwo/limen/releases/download/v#{version}/limen-macos-arm64"
|
||||
sha256 "${SHA_MACOS_ARM64}"
|
||||
elsif OS.mac?
|
||||
url "https://github.com/KofTwentyTwo/limen/releases/download/v#{version}/limen-macos-amd64"
|
||||
sha256 "${SHA_MACOS_AMD64}"
|
||||
elsif linux_arm
|
||||
url "https://github.com/KofTwentyTwo/limen/releases/download/v#{version}/limen-linux-arm64"
|
||||
sha256 "${SHA_LINUX_ARM64}"
|
||||
else
|
||||
url "https://github.com/KofTwentyTwo/limen/releases/download/v#{version}/limen-linux-amd64"
|
||||
sha256 "${SHA_LINUX_AMD64}"
|
||||
end
|
||||
|
||||
def install
|
||||
|
||||
@@ -2,66 +2,83 @@
|
||||
|
||||
> *Latin: "threshold". The doorsill one crosses when entering.*
|
||||
|
||||
A terminal launcher TUI for tmux and SSH. The first thing you see when you open a new terminal: pick a host, pick a session, get to work.
|
||||
A two-stage terminal launcher TUI for tmux and SSH. The first thing you see when opening a new terminal: pick a host, pick a session, get to work.
|
||||
|
||||
**Status:** Early implementation. The binary can launch the host and session picker; see [`docs/DESIGN.md`](docs/DESIGN.md) for the canonical spec.
|
||||
**Status**: Active implementation. The TUI launches host and session pickers. See [`docs/DESIGN.md`](docs/DESIGN.md) for the canonical architecture specification.
|
||||
|
||||
---
|
||||
|
||||
## What it does
|
||||
## What It Does
|
||||
|
||||
Replaces tmux's name-prompt-on-launch with a two-stage TUI:
|
||||
`limen` replaces tmux's default name-prompt-on-launch with an interactive, keyboard-driven TUI:
|
||||
|
||||
1. **Host picker** — choose `localhost` or one of your declared SSH targets. Live status dots show which hosts are reachable and how many sessions each has.
|
||||
2. **Session picker** — pick an existing tmux session to attach to, or create a new one with a name. Works the same whether the host is local or remote.
|
||||
1. **Host Picker**: Choose `localhost` or one of your declared SSH targets. Live status indicators show reachability and active session counts.
|
||||
2. **Session Picker**: Pick an existing tmux session to attach to, or spawn a new named session. Behaves consistently across local and remote targets.
|
||||
|
||||
Press `Esc` at any point and `limen` drops you into a fresh unnamed tmux session at the appropriate host. No deliberation tax.
|
||||
Pressing `Esc` at any stage drops you into a fresh unnamed tmux session at the selected host with zero deliberation tax.
|
||||
|
||||
```
|
||||
╭─ limen ─────────────────────────╮ ╭─ DETAILS ──────────────────────────╮
|
||||
│ │ │ │
|
||||
│ ● localhost (renova) 3 sess. │ │ prod │
|
||||
│ ● prod 2 sess. │ ◀ │ ──────────────────────────────────│
|
||||
│ ● dev 1 sess. │ │ deploy@prod-server-01.example.com │
|
||||
│ ○ builder unreach. │ │ │
|
||||
│ ● sandbox — │ │ Status: ● online │
|
||||
│ │ │ Sessions: 2 (api, ops) │
|
||||
│ │ │ Last attached: 2 hours ago │
|
||||
│ │ │ │
|
||||
│ │ │ Production application servers. │
|
||||
╰─────────────────────────────────╯ ╰────────────────────────────────────╯
|
||||
|
||||
↑↓ navigate · enter connect · / search · ? help · esc skip
|
||||
```
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Install
|
||||
## Tech Stack & Architecture
|
||||
|
||||
Install with Nix:
|
||||
- **Language & Runtime**: Go 1.22+
|
||||
- **TUI Engine**: [Charm Bubble Tea](https://github.com/charmbracelet/bubbletea) (Elm Architecture) & [Lip Gloss](https://github.com/charmbracelet/lipgloss) styling
|
||||
- **Orchestration**: `tmux` IPC & native OpenSSH background client stream
|
||||
- **Configuration**: Single JSON fleet declaration at `~/.config/limen/hosts.json`
|
||||
|
||||
```bash
|
||||
nix run github:KofTwentyTwo/limen
|
||||
```
|
||||
---
|
||||
|
||||
Install with Homebrew after the first tagged release:
|
||||
## Installation
|
||||
|
||||
### Homebrew (macOS / Linux)
|
||||
```bash
|
||||
brew install KofTwentyTwo/tap/limen
|
||||
```
|
||||
|
||||
Prebuilt binaries are published to the GitHub Releases page for:
|
||||
### Nix Flake Run
|
||||
```bash
|
||||
nix run github:KofTwentyTwo/limen
|
||||
```
|
||||
|
||||
| Platform | Architecture | Binary |
|
||||
|----------|--------------|--------|
|
||||
| Linux | x64 | `limen-linux-amd64` |
|
||||
| Linux | ARM64 | `limen-linux-arm64` |
|
||||
| macOS | Intel | `limen-macos-amd64` |
|
||||
| macOS | Apple Silicon | `limen-macos-arm64` |
|
||||
### Binary Releases
|
||||
Pre-built binaries are available on the [Releases](https://github.com/KofTwentyTwo/limen/releases) page:
|
||||
|
||||
## Configuration
|
||||
| Platform | Architecture | Binary Name |
|
||||
| :--- | :--- | :--- |
|
||||
| **Linux** | x86_64 | `limen-linux-amd64` |
|
||||
| **Linux** | ARM64 | `limen-linux-arm64` |
|
||||
| **macOS** | Intel | `limen-macos-amd64` |
|
||||
| **macOS** | Apple Silicon | `limen-macos-arm64` |
|
||||
|
||||
A single JSON file at `~/.config/limen/hosts.json` declares your fleet. Example:
|
||||
---
|
||||
|
||||
## Local Build & Verification
|
||||
|
||||
### Build from Source
|
||||
```bash
|
||||
# Build binary
|
||||
go build -ldflags="-s -w" -o bin/limen ./cmd/limen
|
||||
|
||||
# Or build via Nix
|
||||
nix build
|
||||
```
|
||||
|
||||
### Quality Gates & Verification
|
||||
```bash
|
||||
# 1. Run Unit & Integration Tests
|
||||
go test -v ./...
|
||||
|
||||
# 2. Run Go Linter & Vet
|
||||
go vet ./...
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Fleet Configuration
|
||||
|
||||
Declare target hosts in `~/.config/limen/hosts.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -73,30 +90,10 @@ A single JSON file at `~/.config/limen/hosts.json` declares your fleet. Example:
|
||||
}
|
||||
```
|
||||
|
||||
`localhost` is implicit and always available — never declare it in this file.
|
||||
|
||||
See [`docs/DESIGN.md` §7.1](docs/DESIGN.md) for the full schema.
|
||||
`localhost` is implicit and managed automatically by `limen`. See [`docs/DESIGN.md`](docs/DESIGN.md) for full schema specifications.
|
||||
|
||||
---
|
||||
|
||||
## Design
|
||||
|
||||
The full design and requirements document lives at [`docs/DESIGN.md`](docs/DESIGN.md). That document is the source of truth for what `limen` is and should be; implementation work proceeds from there.
|
||||
|
||||
## Status & roadmap
|
||||
|
||||
Implementation lands on the `develop` branch. Tagged releases publish prebuilt binaries and update the Homebrew tap.
|
||||
|
||||
## Contributing
|
||||
|
||||
See [`CONTRIBUTING.md`](CONTRIBUTING.md).
|
||||
|
||||
## License
|
||||
|
||||
[GPL-3.0](LICENSE).
|
||||
|
||||
## See also
|
||||
|
||||
- [tmux](https://github.com/tmux/tmux/wiki) — the multiplexer `limen` orchestrates
|
||||
- [bubbletea](https://github.com/charmbracelet/bubbletea) — the TUI framework `limen` is built on
|
||||
- [WezTerm](https://wezfurlong.org/wezterm/) — the terminal `limen` is designed to live inside
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 20 KiB |
+15
-21
@@ -6,28 +6,22 @@ class Limen < Formula
|
||||
|
||||
depends_on "tmux"
|
||||
|
||||
on_macos do
|
||||
on_arm do
|
||||
url "https://github.com/KofTwentyTwo/limen/releases/download/v#{version}/limen-macos-arm64"
|
||||
sha256 "PLACEHOLDER_MACOS_ARM64_SHA256"
|
||||
end
|
||||
host_cpu = RbConfig::CONFIG.fetch("host_cpu", "")
|
||||
macos_arm = OS.mac? && (Hardware::CPU.arm? || host_cpu == "arm64" || RUBY_PLATFORM.start_with?("arm64-darwin"))
|
||||
linux_arm = OS.linux? && (Hardware::CPU.arm? || host_cpu == "aarch64" || host_cpu == "arm64")
|
||||
|
||||
on_intel do
|
||||
url "https://github.com/KofTwentyTwo/limen/releases/download/v#{version}/limen-macos-amd64"
|
||||
sha256 "PLACEHOLDER_MACOS_AMD64_SHA256"
|
||||
end
|
||||
end
|
||||
|
||||
on_linux do
|
||||
on_arm do
|
||||
url "https://github.com/KofTwentyTwo/limen/releases/download/v#{version}/limen-linux-arm64"
|
||||
sha256 "PLACEHOLDER_LINUX_ARM64_SHA256"
|
||||
end
|
||||
|
||||
on_intel do
|
||||
url "https://github.com/KofTwentyTwo/limen/releases/download/v#{version}/limen-linux-amd64"
|
||||
sha256 "PLACEHOLDER_LINUX_AMD64_SHA256"
|
||||
end
|
||||
if macos_arm
|
||||
url "https://github.com/KofTwentyTwo/limen/releases/download/v#{version}/limen-macos-arm64"
|
||||
sha256 "PLACEHOLDER_MACOS_ARM64_SHA256"
|
||||
elsif OS.mac?
|
||||
url "https://github.com/KofTwentyTwo/limen/releases/download/v#{version}/limen-macos-amd64"
|
||||
sha256 "PLACEHOLDER_MACOS_AMD64_SHA256"
|
||||
elsif linux_arm
|
||||
url "https://github.com/KofTwentyTwo/limen/releases/download/v#{version}/limen-linux-arm64"
|
||||
sha256 "PLACEHOLDER_LINUX_ARM64_SHA256"
|
||||
else
|
||||
url "https://github.com/KofTwentyTwo/limen/releases/download/v#{version}/limen-linux-amd64"
|
||||
sha256 "PLACEHOLDER_LINUX_AMD64_SHA256"
|
||||
end
|
||||
|
||||
def install
|
||||
|
||||
Reference in new issue
Block a user