Skip to content

feat: add --here flag to run dashboard in current terminal#2

Closed
Oregand wants to merge 1 commit intoDUBSOpenHub:mainfrom
Oregand:feature/optional-new-terminal
Closed

feat: add --here flag to run dashboard in current terminal#2
Oregand wants to merge 1 commit intoDUBSOpenHub:mainfrom
Oregand:feature/optional-new-terminal

Conversation

@Oregand
Copy link
Copy Markdown
Contributor

@Oregand Oregand commented Apr 16, 2026

Summary

By default, start.sh opens the dashboard in a new terminal window. This PR adds a --here flag so users can optionally run it in the current terminal instead.

Motivation

Useful for:

  • Remote SSH sessions where spawning a new window isn't possible
  • tmux/screen panes where you want the dashboard in a specific split
  • Workflows where opening a new window is undesirable

Changes

  • start.sh — Parses --here flag; when set, runs directly via exec instead of spawning a new window. Other args are passed through to agent_pulse.py.
  • README.md — Documents the --here flag, adds an agentpulse-here alias suggestion, and separates launcher vs dashboard options.
  • quickstart.sh — Mentions --here in post-install output.
  • AGENTS.md — Updates the start.sh description.

Usage

# Default — opens in a new terminal window (unchanged)
agentpulse

# New — run in the current terminal
agentpulse --here

# Combine with other flags
agentpulse --here --no-splash

By default, `start.sh` opens the dashboard in a new terminal window.
The new `--here` flag lets users run it in the current terminal instead,
which is useful for remote SSH sessions, tmux panes, or when a new
window is not desired.

Changes:
- start.sh: parse --here flag, skip new-window spawn when set
- README.md: document --here flag and add agentpulse-here alias
- quickstart.sh: mention --here in post-install output
- AGENTS.md: update start.sh description

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
DUBSOpenHub added a commit that referenced this pull request Apr 20, 2026
…tion + --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>
@DUBSOpenHub
Copy link
Copy Markdown
Owner

Thanks @Oregand! 🙏 Your --here flag shipped in #3 exactly as you designed it — same name, same semantics, same motivation (SSH / tmux / in-place). Combined it with the Homebrew + multi-terminal detection from #1. Really appreciate the clean, surgical PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants