Skip to content

doc: add alternative gentle-hint pattern for server SSH workflow#175

Open
Cedar17 wants to merge 1 commit into
neurosnap:mainfrom
Cedar17:main
Open

doc: add alternative gentle-hint pattern for server SSH workflow#175
Cedar17 wants to merge 1 commit into
neurosnap:mainfrom
Cedar17:main

Conversation

@Cedar17

@Cedar17 Cedar17 commented Jun 20, 2026

Copy link
Copy Markdown

Summary

The current session-picker docs only show an auto-launch pattern (zmx-select && exit), which forces the interactive picker on every SSH login. This is inconvenient on shared or dev servers where you frequently SSH in to run quick commands and dont want to be prompted every time.

What this adds

A new Alternative: gentle hint (server use) subsection inside the session-picker docs, with a shell snippet that:

  • Checks for active zmx sessions on SSH login
  • Shows a one-line hint: zmx: N session(s) active — zmx-select to attach
  • Does NOT block the shell or launch the picker
  • Lets the user decide whether to call zmx-select manually

Why separate from the auto-launch pattern

The two patterns serve different use cases:

Pattern Best for
Auto-launch (zmx-select && exit) Dedicated dev machines, single-purpose SSH
Gentle hint (this PR) Shared servers, frequent quick commands

Users can pick whichever fits their workflow.

🤖 Generated with Claude Code

The existing session-picker docs only show an auto-launch pattern
(zmx-select && exit), which forces the picker on every SSH login.
This is inconvenient on shared servers where quick commands are common.

Add an alternative 'gentle hint' pattern that shows a one-line
reminder when sessions exist, without blocking the shell.

Co-Authored-By: Claude <noreply@anthropic.com>
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.

1 participant