betterterm 1.0.0

package/README.md

@@ -0,0 +1,60 @@
+# betterterm
+
+Terminal IDE setup: Ghostty + tmux + yazi + carbonyl browser.
+
+## Install
+
+```bash
+npx betterterm
+```
+
+## Requirements
+
+- **macOS** with [Homebrew](https://brew.sh)
+- **[Ghostty](https://ghostty.org)** terminal emulator
+
+The installer handles everything else (tmux, yazi, carbonyl).
+
+## What it does
+
+- Installs tmux, yazi, and carbonyl via Homebrew/npm
+- Configures tmux with a clean status bar, mouse support, and keybindings
+- Sets up yazi as a toggleable file explorer with cd-to-terminal sync
+- Adds an in-terminal browser (carbonyl) toggled via hotkey
+- Patches your Ghostty config with Cmd-key shortcuts that map to tmux
+
+## Keybindings
+
+| Key | Action |
+|-----|--------|
+| `Cmd+E` | Toggle file explorer (yazi) |
+| `Cmd+Y` | Toggle browser (carbonyl) |
+| `Cmd+Shift+Y` | Close browser |
+| `Cmd+L` | Browser URL bar |
+| `Cmd+T` | New tmux window |
+| `Cmd+]` | Next window |
+| `Cmd+[` | Previous window |
+| `Cmd+\` | Split pane vertically |
+| `Cmd+-` | Split pane horizontally |
+| `Cmd+Arrow` | Resize pane |
+| `Cmd+R` | Reload tmux config |
+| `Ctrl+B, Tab` | Toggle between panes |
+
+## Uninstall
+
+The installer backs up any existing configs to `*.backup` files. To revert:
+
+```bash
+# Restore configs
+mv ~/.tmux.conf.backup ~/.tmux.conf
+mv ~/.config/yazi/yazi.toml.backup ~/.config/yazi/yazi.toml
+mv ~/.config/yazi/keymap.toml.backup ~/.config/yazi/keymap.toml
+
+# Remove betterterm block from Ghostty config (between the marker comments)
+# Remove scripts
+rm ~/.local/bin/betterterm*.sh ~/.local/bin/toggle-*.sh ~/.local/bin/open-browser.sh ~/.local/bin/close-browser.sh ~/.local/bin/browser-nav.sh
+```
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,226 @@
+#!/usr/bin/env node
+
+const { execSync, spawnSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+const HOME = os.homedir();
+const PKG_ROOT = path.resolve(__dirname, "..");
+
+// ── Helpers ──────────────────────────────────────────────
+
+function run(cmd, opts = {}) {
+  try {
+    return execSync(cmd, { encoding: "utf-8", stdio: "pipe", ...opts }).trim();
+  } catch {
+    return null;
+  }
+}
+
+function which(bin) {
+  return run(`which ${bin}`);
+}
+
+function log(msg) {
+  console.log(`  \x1b[32m✓\x1b[0m ${msg}`);
+}
+
+function warn(msg) {
+  console.log(`  \x1b[33m⚠\x1b[0m ${msg}`);
+}
+
+function err(msg) {
+  console.error(`  \x1b[31m✗\x1b[0m ${msg}`);
+}
+
+function heading(msg) {
+  console.log(`\n\x1b[1m${msg}\x1b[0m`);
+}
+
+function backup(filePath) {
+  if (fs.existsSync(filePath)) {
+    const content = fs.readFileSync(filePath, "utf-8");
+    if (content.includes("betterterm")) {
+      return false; // Already a betterterm config, no backup needed
+    }
+    const backupPath = filePath + ".backup";
+    fs.copyFileSync(filePath, backupPath);
+    warn(`Backed up existing ${filePath} → ${backupPath}`);
+    return true;
+  }
+  return false;
+}
+
+function ensureDir(dir) {
+  fs.mkdirSync(dir, { recursive: true });
+}
+
+// ── 1. Check for Homebrew ────────────────────────────────
+
+heading("betterterm setup");
+
+if (!which("brew")) {
+  err("Homebrew is required but not installed.");
+  console.log("    Install it: https://brew.sh");
+  process.exit(1);
+}
+log("Homebrew found");
+
+// ── 2. Install brew dependencies ─────────────────────────
+
+heading("Installing dependencies...");
+
+const brewDeps = ["tmux", "yazi"];
+for (const dep of brewDeps) {
+  if (which(dep)) {
+    log(`${dep} already installed`);
+  } else {
+    console.log(`  Installing ${dep}...`);
+    const result = spawnSync("brew", ["install", dep], { stdio: "inherit" });
+    if (result.status !== 0) {
+      err(`Failed to install ${dep}`);
+      process.exit(1);
+    }
+    log(`${dep} installed`);
+  }
+}
+
+// ── 3. Install carbonyl ──────────────────────────────────
+
+const carbonylDir = path.join(HOME, ".local/lib/node_modules/carbonyl");
+if (fs.existsSync(carbonylDir)) {
+  log("carbonyl already installed");
+} else {
+  console.log("  Installing carbonyl (this may take a moment)...");
+  const result = spawnSync(
+    "npm",
+    ["install", "--global", "carbonyl", "--prefix", path.join(HOME, ".local")],
+    { stdio: "inherit" }
+  );
+  if (result.status !== 0) {
+    warn("carbonyl installation failed — browser features won't work");
+  } else {
+    log("carbonyl installed");
+  }
+}
+
+// ── 4. Copy scripts to ~/.local/bin/ ─────────────────────
+
+heading("Installing scripts...");
+
+const binDir = path.join(HOME, ".local/bin");
+ensureDir(binDir);
+
+const scripts = fs.readdirSync(path.join(PKG_ROOT, "scripts"));
+for (const script of scripts) {
+  const src = path.join(PKG_ROOT, "scripts", script);
+  const dest = path.join(binDir, script);
+  fs.copyFileSync(src, dest);
+  fs.chmodSync(dest, 0o755);
+  log(`${script} → ${dest}`);
+}
+
+// ── 5. Copy configs ──────────────────────────────────────
+
+heading("Installing configs...");
+
+// tmux.conf
+const tmuxDest = path.join(HOME, ".tmux.conf");
+backup(tmuxDest);
+fs.copyFileSync(path.join(PKG_ROOT, "configs/tmux.conf"), tmuxDest);
+log(`tmux.conf → ${tmuxDest}`);
+
+// yazi configs
+const yaziDir = path.join(HOME, ".config/yazi");
+ensureDir(yaziDir);
+
+const yaziTomlDest = path.join(yaziDir, "yazi.toml");
+backup(yaziTomlDest);
+fs.copyFileSync(path.join(PKG_ROOT, "configs/yazi.toml"), yaziTomlDest);
+log(`yazi.toml → ${yaziTomlDest}`);
+
+const keymapDest = path.join(yaziDir, "keymap.toml");
+backup(keymapDest);
+fs.copyFileSync(path.join(PKG_ROOT, "configs/keymap.toml"), keymapDest);
+log(`keymap.toml → ${keymapDest}`);
+
+// yazi plugin
+const pluginDir = path.join(yaziDir, "plugins/cd-terminal.yazi");
+ensureDir(pluginDir);
+fs.copyFileSync(
+  path.join(PKG_ROOT, "plugins/cd-terminal.yazi/init.lua"),
+  path.join(pluginDir, "init.lua")
+);
+log(`cd-terminal.yazi plugin → ${pluginDir}/init.lua`);
+
+// ── 6. Patch Ghostty config ─────────────────────────────
+
+heading("Configuring Ghostty...");
+
+const ghosttyDir = path.join(HOME, ".config/ghostty");
+const ghosttyConfig = path.join(ghosttyDir, "config");
+const ghosttyBlock = fs.readFileSync(
+  path.join(PKG_ROOT, "configs/ghostty.conf"),
+  "utf-8"
+);
+
+ensureDir(ghosttyDir);
+
+if (fs.existsSync(ghosttyConfig)) {
+  let content = fs.readFileSync(ghosttyConfig, "utf-8");
+  const startMarker = "# --- betterterm start ---";
+  const endMarker = "# --- betterterm end ---";
+  const startIdx = content.indexOf(startMarker);
+  const endIdx = content.indexOf(endMarker);
+
+  if (startIdx !== -1 && endIdx !== -1) {
+    // Replace existing block
+    content =
+      content.substring(0, startIdx) +
+      ghosttyBlock.trimEnd() +
+      "\n" +
+      content.substring(endIdx + endMarker.length + 1);
+    fs.writeFileSync(ghosttyConfig, content);
+    log("Updated existing betterterm block in Ghostty config");
+  } else {
+    // Append block
+    const separator = content.endsWith("\n") ? "\n" : "\n\n";
+    fs.appendFileSync(ghosttyConfig, separator + ghosttyBlock);
+    log("Appended betterterm block to Ghostty config");
+  }
+} else {
+  fs.writeFileSync(ghosttyConfig, ghosttyBlock);
+  log("Created Ghostty config with betterterm block");
+}
+
+// ── 7. Check PATH ────────────────────────────────────────
+
+const pathDirs = (process.env.PATH || "").split(":");
+if (!pathDirs.includes(binDir)) {
+  warn(`${binDir} is not in your PATH`);
+  console.log(`    Add this to your shell profile (~/.zshrc or ~/.bashrc):`);
+  console.log(`    export PATH="$HOME/.local/bin:$PATH"`);
+}
+
+// ── 8. Summary ───────────────────────────────────────────
+
+heading("Setup complete!");
+console.log(`
+  Restart Ghostty to activate betterterm.
+
+  \x1b[1mKeybindings:\x1b[0m
+    Cmd+E           Toggle file explorer (yazi)
+    Cmd+Y           Toggle browser (carbonyl)
+    Cmd+Shift+Y     Close browser
+    Cmd+L           Browser URL bar
+    Cmd+T           New tmux window
+    Cmd+]           Next window
+    Cmd+[           Previous window
+    Cmd+\\           Split pane vertically
+    Cmd+-           Split pane horizontally
+    Cmd+Arrow       Resize pane
+    Cmd+R           Reload tmux config
+    Ctrl+B, Tab     Toggle between panes
+    Opt+Enter       Send Enter to terminal
+`);

package/configs/ghostty.conf

@@ -0,0 +1,24 @@
+# --- betterterm start ---
+
+# Launch tmux with betterterm
+command = ~/.local/bin/betterterm.sh
+
+# Cmd shortcuts → tmux (sends Ctrl+B prefix then the key)
+keybind = cmd+e=text:\x02e
+keybind = cmd+shift+tab=text:\x02\t
+keybind = cmd+up=text:\x02\x1b[A
+keybind = cmd+down=text:\x02\x1b[B
+keybind = cmd+left=text:\x02\x1b[D
+keybind = cmd+right=text:\x02\x1b[C
+keybind = cmd+backslash=text:\x02|
+keybind = cmd+-=text:\x02-
+keybind = cmd+r=text:\x02r
+keybind = cmd+y=text:\x02b
+keybind = cmd+shift+y=text:\x02B
+keybind = cmd+l=text:\x02l
+keybind = opt+enter=text:\x0d
+keybind = cmd+t=text:\x02c
+keybind = cmd+]=text:\x02n
+keybind = cmd+[=text:\x02p
+
+# --- betterterm end ---

package/configs/keymap.toml

@@ -0,0 +1,4 @@
+[[mgr.prepend_keymap]]
+on = ["<Enter>"]
+run = ["enter", "plugin cd-terminal"]
+desc = "Enter directory and cd terminal there"

package/configs/tmux.conf

@@ -0,0 +1,62 @@
+# --- betterterm tmux config ---
+
+# Terminal compatibility (fixes yazi terminal response timeout)
+set -g default-terminal "tmux-256color"
+set -ga terminal-overrides ",xterm-ghostty:RGB,xterm-256color:RGB"
+set -g allow-passthrough on
+set -g escape-time 0
+set -ga update-environment "TERM TERM_PROGRAM TERM_PROGRAM_VERSION"
+
+# Mouse support (resize panes by dragging borders, click to focus, scroll)
+set -g mouse on
+
+# Start window/pane numbering at 1
+set -g base-index 1
+setw -g pane-base-index 1
+
+# Quick toggle: jump between terminal and yazi panes
+bind Tab select-pane -t :.+
+
+# Toggle yazi file explorer (Ctrl+B then e)
+bind e run-shell "~/.local/bin/toggle-yazi.sh"
+
+# Toggle browser (Ctrl+B then b) / Close browser (Ctrl+B then B)
+bind b run-shell "~/.local/bin/toggle-browser.sh"
+bind B run-shell "~/.local/bin/close-browser.sh"
+bind l run-shell "~/.local/bin/browser-nav.sh"
+
+# Resize panes with prefix + arrow keys (5 cells at a time)
+bind -r Up resize-pane -U 5
+bind -r Down resize-pane -D 5
+bind -r Left resize-pane -L 5
+bind -r Right resize-pane -R 5
+
+# Reload config with prefix + r
+bind r source-file ~/.tmux.conf \; display "Config reloaded"
+
+# Better split keybindings
+bind | split-window -h -c "#{pane_current_path}"
+bind - split-window -v -c "#{pane_current_path}"
+
+# Don't rename windows automatically
+set -g allow-rename off
+
+# --- Appearance ---
+set -g status-position bottom
+set -g status-style "bg=#1a1a1a,fg=#888888"
+
+# Left: status buttons (visual indicators + hotkey reminders)
+set -g status-left-length 50
+set -g status-left "#[fg=#888888,bg=#2a2a2a] Files:Cmd+E #[default] #[fg=#888888,bg=#2a2a2a] Browser:Cmd+Y #[default] "
+
+# Window list
+setw -g window-status-format "#[fg=#555555]#I:#W"
+setw -g window-status-current-format "#[fg=#cccccc,bold]#I:#W"
+
+# Right: system stats + time
+set -g status-right-length 60
+set -g status-right "#[fg=#555555]#(~/.local/bin/betterterm-stats.sh)  #[fg=#888888]%H:%M"
+set -g status-interval 5
+
+set -g pane-border-style "fg=#333333"
+set -g pane-active-border-style "fg=#888888"

package/configs/yazi.toml

@@ -0,0 +1,11 @@
+[mgr]
+ratio = [1, 3, 3]
+
+[preview]
+image_filter = "triangle"
+image_quality = 75
+
+[opener]
+
+[plugin]
+preload_image = false

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "betterterm",
+  "version": "1.0.0",
+  "description": "Terminal IDE setup: Ghostty + tmux + yazi + carbonyl browser",
+  "bin": {
+    "betterterm": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "configs/",
+    "scripts/",
+    "plugins/"
+  ],
+  "keywords": [
+    "terminal",
+    "tmux",
+    "yazi",
+    "ghostty",
+    "ide",
+    "cli"
+  ],
+  "author": "Myles",
+  "license": "MIT"
+}

package/plugins/cd-terminal.yazi/init.lua

@@ -0,0 +1,11 @@
+--- cd-terminal plugin: sends cd command to the left tmux pane
+return {
+	entry = function()
+		local dir = cx.active.current.cwd
+		local cmd = string.format(
+			"tmux send-keys -t 1 'cd %q' Enter",
+			tostring(dir)
+		)
+		os.execute(cmd)
+	end,
+}

package/scripts/betterterm-stats.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+# CPU usage (normalized to 100%)
+CORES=$(sysctl -n hw.logicalcpu)
+CPU=$(ps -A -o %cpu | awk -v c="$CORES" '{s+=$1} END {printf "%.0f", s/c}')
+# Memory usage
+MEM=$(ps -A -o %mem | awk '{s+=$1} END {printf "%.0f", s}')
+echo "CPU ${CPU}%  MEM ${MEM}%"

package/scripts/betterterm.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Start tmux with just a terminal (no file explorer)
+TMUX=$(which tmux)
+
+# Use first argument as starting dir, or current dir, or home
+DIR="${1:-${PWD:-$HOME}}"
+
+# Kill old session if it exists to get a clean start
+$TMUX kill-session -t main 2>/dev/null
+
+# Create new session in the target directory (just the shell)
+$TMUX new-session -d -s main -c "$DIR"
+
+# Attach
+$TMUX attach-session -t main

package/scripts/browser-nav.sh

@@ -0,0 +1,6 @@
+#!/bin/bash
+# Open URL bar — kills current browser and prompts for new URL
+T=$(which tmux)
+$T kill-window -t browser 2>/dev/null
+$T command-prompt -p "URL:" "run-shell \"~/.local/bin/open-browser.sh '%%'\""
+exit 0

package/scripts/close-browser.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Close the browser window
+T=$(which tmux)
+$T kill-window -t browser 2>/dev/null
+exit 0

package/scripts/open-browser.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+# Open carbonyl with auto https://
+T=$(which tmux)
+CARBONYL_DIR="$HOME/.local/lib/node_modules/carbonyl/node_modules/@fathyb/carbonyl-macos-arm64/build"
+
+URL="$1"
+
+# Add protocol if not specified
+if [[ "$URL" != http://* && "$URL" != https://* ]]; then
+    if [[ "$URL" == localhost* || "$URL" == 127.0.0.1* ]]; then
+        URL="http://$URL"
+    else
+        URL="https://$URL"
+    fi
+fi
+
+$T new-window -n browser -e TERM=xterm-256color "cd '$CARBONYL_DIR' && ./carbonyl --zoom=50 '$URL'"
+exit 0

package/scripts/toggle-browser.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+# Toggle carbonyl browser as a full tmux window
+T=$(which tmux)
+CARBONYL_DIR="$HOME/.local/lib/node_modules/carbonyl/node_modules/@fathyb/carbonyl-macos-arm64/build"
+
+# Check if browser window exists
+browser_win=$($T list-windows -F '#{window_index} #{window_name}' 2>/dev/null | grep browser | head -1 | awk '{print $1}')
+
+if [ -n "$browser_win" ]; then
+    # Browser exists — toggle between browser and terminal
+    current=$($T display-message -p '#{window_name}')
+    if [ "$current" = "browser" ]; then
+        $T select-window -t 1
+    else
+        $T select-window -t browser
+    fi
+else
+    # Prompt for URL, launch browser
+    $T command-prompt -p "URL:" "run-shell \"~/.local/bin/open-browser.sh '%%'\""
+fi
+exit 0

package/scripts/toggle-yazi.sh

@@ -0,0 +1,12 @@
+#!/bin/bash
+# Toggle yazi file explorer pane in tmux
+T=$(which tmux)
+pane_count=$($T display-message -p '#{window_panes}')
+if [ "$pane_count" -gt 1 ]; then
+    $T kill-pane -t {right}
+else
+    DIR=$($T display-message -p '#{pane_current_path}')
+    $T split-window -h -l 30% -c "$DIR" "env TERM=xterm-256color $(which yazi) $DIR"
+    $T select-pane -t 0
+fi
+exit 0