mtm-ssh-menu/README.md

mtm-ssh-menu

A small Bash utility to browse SSH targets from YAML configuration and connect to them with fzf.

Features

• Interactive selection with fzf
• Global defaults for SSH user, port, and jump hosts
• Per-host overrides in grouped YAML files
• Support for jump hosts via named aliases
• Simple, dependency-light Bash script

Requirements

• bash
• ssh
• fzf
• jq
• yq

Usage

./mtm-ssh-menu [--config-dir DIR]

Options:

• --help: show help
• --config-dir DIR: use a custom configuration directory

By default, the script reads configuration from:

• ~/.config/mtm-ssh-menu/global.yaml
• ~/.config/mtm-ssh-menu/hosts/*.yaml

Configuration format

global.yaml

ssh:
  default_user: root
  default_port: 22
  default_options: ""
  jump_hosts:
    office: "user@192.168.10.11"

hosts/dev.yaml

group: dev
servers:
  - name: api-1
    aliases:
      - api
      - backend
    host: 192.168.10.11
    user: dev
    port: 2222

Each host entry can define:

• name
• aliases
• host
• user
• port
• jump_host

Example workflow

1. Create the config directory.
2. Add global.yaml and one or more files under hosts/.
3. Run the script.
4. Select a target in the menu and connect.

Sample configuration

A complete sample configuration is available in sample-config/.

Notes

• The script requires yq, jq, ssh, and fzf to be installed.
• Jump hosts are resolved by name from global.yaml.
• If a host does not define a user or port, global defaults are used.