Combine launcher improvements: Homebrew + fish + multi-terminal detection + --here (#3)

* Combine launcher improvements from PR #1 and PR #2

Cherry-picks the best of both PRs without flipping the beginner-friendly
default (new window = wow factor on first run).

From #1 (@djensenius):
- Homebrew formula (Formula/agent-pulse.rb) + release workflow that
  auto-updates the tarball URL + SHA256 on new releases
- Fish shell alias support in quickstart.sh (alongside bash/zsh)
- Multi-terminal-emulator auto-detection in start.sh:
  Ghostty, iTerm, Kitty, WezTerm, Alacritty, Warp, Terminal.app, tmux,
  gnome-terminal, xterm, with sensible fallbacks

From #2 (@Oregand):
- --here flag to run the dashboard in the current terminal
  (SSH sessions, tmux panes, in-place workflows)

Docs updated (README, AGENTS.md, quickstart.sh) to describe both flows
and the new agentpulse-here alias.

Keeps default behaviour (opens a new window) so the first-run
experience stays delightful for non-developers.

Co-authored-by: djensenius <782512+djensenius@users.noreply.github.com>
Co-authored-by: Oregand <4388753+Oregand@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Docs: update copilot-instructions and site for new launcher + Homebrew

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Gregg Cochran <greggcochran@github.com>
Co-authored-by: djensenius <782512+djensenius@users.noreply.github.com>
Co-authored-by: Oregand <4388753+Oregand@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: 5 people

.github/copilot-instructions.md

@@ -7,7 +7,7 @@ agent_pulse.py          — Main dashboard (single-file, Python/Textual/Rich)
 agent_pulse.tcss        — Textual CSS stylesheet (responsive layout)
 pyproject.toml          — Python packaging + console entry point
 requirements.txt        — Python deps (rich>=13.0.0, textual>=0.50.0)
-start.sh                — Launcher (auto-opens in a new terminal window)
+start.sh                — Launcher (auto-detects terminal emulator for new window; --here for in-place)
 quickstart.sh           — One-command installer
 site/index.html         — Showcase website (GitHub Pages)
 experimental/ink/       — React/Ink TUI (experimental, separate stack)

.github/workflows/release.yml

@@ -0,0 +1,70 @@
+name: Release & Update Homebrew Formula
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: write
+
+jobs:
+  update-formula:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: main
+
+      - name: Get release tag
+        id: tag
+        run: echo "version=${GITHUB_REF_NAME#v}" >> "$GITHUB_OUTPUT"
+
+      - name: Download source tarball and compute SHA256
+        id: sha
+        run: |
+          TARBALL_URL="https://github.com/${{ github.repository }}/archive/refs/tags/${GITHUB_REF_NAME}.tar.gz"
+          SHA256=$(curl -sL "$TARBALL_URL" | shasum -a 256 | awk '{print $1}')
+          echo "sha256=$SHA256" >> "$GITHUB_OUTPUT"
+          echo "url=$TARBALL_URL" >> "$GITHUB_OUTPUT"
+
+      - name: Update formula version and SHA256
+        run: |
+          python3 - <<'PYEOF'
+          import re
+
+          with open("Formula/agent-pulse.rb") as f:
+              content = f.read()
+
+          # Update the source url
+          content = re.sub(
+              r'(  url )"https://github\.com/.*/archive/refs/tags/.*\.tar\.gz"',
+              rf'\1"${{ steps.sha.outputs.url }}"',
+              content,
+              count=1,
+          )
+
+          # Update the source sha256 (the one right after the url line, before license)
+          content = re.sub(
+              r'(  url "https://github\.com/.*\.tar\.gz"\n  )sha256 ".*?"',
+              rf'\g<1>sha256 "${{ steps.sha.outputs.sha256 }}"',
+              content,
+              count=1,
+          )
+
+          with open("Formula/agent-pulse.rb", "w") as f:
+              f.write(content)
+          PYEOF
+
+      - name: Verify formula syntax
+        run: ruby -c Formula/agent-pulse.rb
+
+      - name: Commit and push updated formula
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add Formula/agent-pulse.rb
+          git diff --cached --quiet && echo "No changes to commit" && exit 0
+          git commit -m "Update Homebrew formula for ${GITHUB_REF_NAME}
+
+          Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>"
+          git push origin main

AGENTS.md

@@ -13,7 +13,7 @@ Agent Pulse is a real-time terminal dashboard for monitoring GitHub Copilot CLI
 | `agent_pulse.py` | Main dashboard application (all logic, rendering, data collection) | ✅ Primary target |
 | `pyproject.toml` | Python packaging and metadata | Only for version/deps |
 | `requirements.txt` | Python dependency list | Keep in sync with pyproject.toml |
-| `start.sh` | Launcher — auto-opens dashboard in a new terminal window | Rarely |
+| `start.sh` | Launcher — opens dashboard in a new window of the user's terminal (Ghostty/iTerm/Kitty/WezTerm/Alacritty/Warp/Terminal.app/tmux/Linux); `--here` runs in current terminal | Rarely |
 | `site/index.html` | Showcase website | For site updates only |
 | `experimental/ink/` | React/Ink TUI (experimental) | Separate from main app |
 

Formula/agent-pulse.rb

@@ -0,0 +1,70 @@
+class AgentPulse < Formula
+  include Language::Python::Virtualenv
+
+  desc "Real-time terminal dashboard for monitoring GitHub Copilot CLI sessions and agents"
+  homepage "https://github.com/DUBSOpenHub/copilot-cli-agent-pulse"
+  url "https://github.com/DUBSOpenHub/copilot-cli-agent-pulse/archive/refs/tags/v1.0.0.tar.gz"
+  sha256 "PLACEHOLDER"
+  license "MIT"
+
+  depends_on "python@3.12"
+
+  resource "linkify-it-py" do
+    url "https://files.pythonhosted.org/packages/2e/c9/06ea13676ef354f0af6169587ae292d3e2406e212876a413bf9eece4eb23/linkify_it_py-2.1.0.tar.gz"
+    sha256 "43360231720999c10e9328dc3691160e27a718e280673d444c38d7d3aaa3b98b"
+  end
+
+  resource "markdown-it-py" do
+    url "https://files.pythonhosted.org/packages/5b/f5/4ec618ed16cc4f8fb3b701563655a69816155e79e24a17b651541804721d/markdown_it_py-4.0.0.tar.gz"
+    sha256 "cb0a2b4aa34f932c007117b194e945bd74e0ec24133ceb5bac59009cda1cb9f3"
+  end
+
+  resource "mdit-py-plugins" do
+    url "https://files.pythonhosted.org/packages/b2/fd/a756d36c0bfba5f6e39a1cdbdbfdd448dc02692467d83816dff4592a1ebc/mdit_py_plugins-0.5.0.tar.gz"
+    sha256 "f4918cb50119f50446560513a8e311d574ff6aaed72606ddae6d35716fe809c6"
+  end
+
+  resource "mdurl" do
+    url "https://files.pythonhosted.org/packages/d6/54/cfe61301667036ec958cb99bd3efefba235e65cdeb9c84d24a8293ba1d90/mdurl-0.1.2.tar.gz"
+    sha256 "bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba"
+  end
+
+  resource "platformdirs" do
+    url "https://files.pythonhosted.org/packages/9f/4a/0883b8e3802965322523f0b200ecf33d31f10991d0401162f4b23c698b42/platformdirs-4.9.6.tar.gz"
+    sha256 "3bfa75b0ad0db84096ae777218481852c0ebc6c727b3168c1b9e0118e458cf0a"
+  end
+
+  resource "pygments" do
+    url "https://files.pythonhosted.org/packages/c3/b2/bc9c9196916376152d655522fdcebac55e66de6603a76a02bca1b6414f6c/pygments-2.20.0.tar.gz"
+    sha256 "6757cd03768053ff99f3039c1a36d6c0aa0b263438fcab17520b30a303a82b5f"
+  end
+
+  resource "rich" do
+    url "https://files.pythonhosted.org/packages/c0/8f/0722ca900cc807c13a6a0c696dacf35430f72e0ec571c4275d2371fca3e9/rich-15.0.0.tar.gz"
+    sha256 "edd07a4824c6b40189fb7ac9bc4c52536e9780fbbfbddf6f1e2502c31b068c36"
+  end
+
+  resource "textual" do
+    url "https://files.pythonhosted.org/packages/cf/2f/d44f0f12b3ddb1f0b88f7775652e99c6b5a43fd733badf4ce064bdbfef4a/textual-8.2.3.tar.gz"
+    sha256 "beea7b86b03b03558a2224f0cc35252e60ef8b0c4353b117b2f40972902d976a"
+  end
+
+  resource "typing_extensions" do
+    url "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz"
+    sha256 "0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466"
+  end
+
+  resource "uc-micro-py" do
+    url "https://files.pythonhosted.org/packages/78/67/9a363818028526e2d4579334460df777115bdec1bb77c08f9db88f6389f2/uc_micro_py-2.0.0.tar.gz"
+    sha256 "c53691e495c8db60e16ffc4861a35469b0ba0821fe409a8a7a0a71864d33a811"
+  end
+
+  def install
+    virtualenv_install_with_resources
+  end
+
+  test do
+    assert_match "Agent Pulse", shell_output("#{bin}/agent-pulse --help")
+    assert_match "{", shell_output("#{bin}/agent-pulse --export")
+  end
+end

README.md

@@ -6,11 +6,25 @@
 
 ### 🚀 Install & Launch
 
+**Homebrew (recommended on macOS):**
+
+```bash
+brew tap DUBSOpenHub/copilot-cli-agent-pulse
+brew install agent-pulse
+```
+
+**Quick installer (any platform):**
+
 ```bash
 curl -fsSL https://raw.githubusercontent.com/DUBSOpenHub/copilot-cli-agent-pulse/main/quickstart.sh | bash
 ```
 
-Then just type `agentpulse` — the dashboard opens in a new terminal window automatically.
+Then just type `agentpulse` — the dashboard opens in a new window of your current
+terminal emulator (auto-detects Ghostty, iTerm, Kitty, WezTerm, Alacritty, Warp,
+Terminal.app, and tmux).
+
+Use `agentpulse --here` to run it in the current terminal instead (handy over SSH
+or inside a tmux pane).
 
 <div align="center">
 
@@ -66,14 +80,17 @@ That's it. The dashboard auto-detects your Copilot CLI sessions and starts monit
 
 ### Shell Commands
 
-Add these aliases to your `~/.zshrc` or `~/.bashrc`:
+Add these aliases to your `~/.zshrc` or `~/.bashrc` (fish users: `~/.config/fish/config.fish`):
 
 ```bash
 alias agentpulse='~/copilot-cli-agent-pulse/start.sh'
 alias agentdashboard='~/copilot-cli-agent-pulse/start.sh'
+alias agentpulse-here='~/copilot-cli-agent-pulse/start.sh --here'
 ```
 
-Then just type **`agentpulse`** or **`agentdashboard`** from anywhere — the live dashboard **automatically opens in a new terminal window** so it never blocks your current session.
+Then just type **`agentpulse`** or **`agentdashboard`** from anywhere — the live dashboard **automatically opens in a new terminal window** so it never blocks your current session. The launcher auto-detects **Ghostty, iTerm, Kitty, WezTerm, Alacritty, Warp, Terminal.app, tmux, gnome-terminal,** and **xterm**.
+
+Use **`agentpulse --here`** (or the `agentpulse-here` alias) to run the dashboard **in the current terminal** instead — ideal for SSH sessions or tmux panes.
 
 ---
 
@@ -85,7 +102,13 @@ Then just type **`agentpulse`** or **`agentdashboard`** from anywhere — the li
 | **Export** | `python agent_pulse.py --export` | JSON export to stdout |
 | **No Splash** | `python agent_pulse.py --no-splash` | Skip boot animation |
 
-### Options
+### Launcher Options
+
+| Flag | Description |
+|------|-------------|
+| `--here` | Run in the current terminal instead of opening a new window |
+
+### Dashboard Options
 
 ```
 --export,    -e          Export JSON to stdout
@@ -192,7 +215,7 @@ copilot-cli-agent-pulse/
 ├── agent_pulse.tcss         # Textual CSS stylesheet
 ├── pyproject.toml            # Python packaging + entry point
 ├── requirements.txt          # Python dependencies (rich, textual)
-├── start.sh                  # Launcher (auto-opens in new terminal window)
+├── start.sh                  # Launcher (auto-detects terminal emulator; --here for in-place)
 ├── quickstart.sh             # One-command installer
 ├── site/                     # Showcase website (GitHub Pages)
 │   └── index.html

quickstart.sh

@@ -35,20 +35,43 @@ echo "  ✅ Installed to $DEST"
 echo ""
 
 # Auto-add shell aliases if not already present
+FISH_CONFIG="$HOME/.config/fish/config.fish"
 SHELL_RC=""
 if [ -f "$HOME/.zshrc" ]; then
   SHELL_RC="$HOME/.zshrc"
 elif [ -f "$HOME/.bashrc" ]; then
   SHELL_RC="$HOME/.bashrc"
 fi
 
+ALIASES_ADDED=0
+
+# bash/zsh aliases
 if [ -n "$SHELL_RC" ] && ! grep -q 'alias agentpulse=' "$SHELL_RC" 2>/dev/null; then
   echo "" >> "$SHELL_RC"
-  echo "# Agent Pulse — auto-opens live dashboard in a new terminal window" >> "$SHELL_RC"
+  echo "# Agent Pulse — live terminal dashboard" >> "$SHELL_RC"
   echo "alias agentpulse='~/copilot-cli-agent-pulse/start.sh'" >> "$SHELL_RC"
   echo "alias agentdashboard='~/copilot-cli-agent-pulse/start.sh'" >> "$SHELL_RC"
-  echo "  🔗 Added 'agentpulse' and 'agentdashboard' aliases to $(basename "$SHELL_RC")"
-else
+  echo "alias agentpulse-here='~/copilot-cli-agent-pulse/start.sh --here'" >> "$SHELL_RC"
+  echo "  🔗 Added 'agentpulse', 'agentdashboard', 'agentpulse-here' aliases to $(basename "$SHELL_RC")"
+  ALIASES_ADDED=1
+fi
+
+# fish aliases (works alongside bash/zsh)
+if [ -f "$FISH_CONFIG" ] || echo "${SHELL:-}" | grep -q fish; then
+  mkdir -p "$(dirname "$FISH_CONFIG")"
+  touch "$FISH_CONFIG"
+  if ! grep -q 'alias agentpulse' "$FISH_CONFIG" 2>/dev/null; then
+    echo "" >> "$FISH_CONFIG"
+    echo "# Agent Pulse — live terminal dashboard" >> "$FISH_CONFIG"
+    echo "alias agentpulse '~/copilot-cli-agent-pulse/start.sh'" >> "$FISH_CONFIG"
+    echo "alias agentdashboard '~/copilot-cli-agent-pulse/start.sh'" >> "$FISH_CONFIG"
+    echo "alias agentpulse-here '~/copilot-cli-agent-pulse/start.sh --here'" >> "$FISH_CONFIG"
+    echo "  🔗 Added 'agentpulse', 'agentdashboard', 'agentpulse-here' aliases to config.fish"
+    ALIASES_ADDED=1
+  fi
+fi
+
+if [ "$ALIASES_ADDED" -eq 0 ]; then
   echo "  🔗 Aliases already configured."
 fi
 
@@ -57,6 +80,9 @@ echo "  Launch it (opens in a new terminal window):"
 echo "    agentpulse"
 echo "    agentdashboard"
 echo ""
+echo "  Run in the current terminal (SSH / tmux / no new window):"
+echo "    agentpulse --here"
+echo ""
 echo "  Or run directly:"
 echo "    $DEST/start.sh"
 echo ""

site/index.html

@@ -817,6 +817,10 @@ <h2 class="section-title glow-green">Up and Running in 30 Seconds</h2>
       </div>
       <div class="terminal-body">
         <div class="install-line"><span class="comment"># Clone the repository</span></div>
+        <div class="install-line"><span class="comment"># Install with Homebrew (macOS)</span></div>
+        <div class="install-line install-line-wrap"><span class="prompt">$ </span><span class="cmd">brew tap DUBSOpenHub/copilot-cli-agent-pulse &amp;&amp; brew install agent-pulse</span><button class="copy-btn" data-cmd="brew tap DUBSOpenHub/copilot-cli-agent-pulse && brew install agent-pulse">COPY</button></div>
+        <div class="install-line">&nbsp;</div>
+        <div class="install-line"><span class="comment"># — or — clone the repository</span></div>
         <div class="install-line install-line-wrap"><span class="prompt">$ </span><span class="cmd">git clone https://github.com/DUBSOpenHub/copilot-cli-agent-pulse.git</span><button class="copy-btn" data-cmd="git clone https://github.com/DUBSOpenHub/copilot-cli-agent-pulse.git">COPY</button></div>
         <div class="install-line">&nbsp;</div>
         <div class="install-line"><span class="comment"># Enter the directory</span></div>