PHPackages                             sugarcraft/sugar-wishlist - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. sugarcraft/sugar-wishlist

ActiveLibrary[Utility & Helpers](/categories/utility)

sugarcraft/sugar-wishlist
=========================

SSH endpoint launcher — a TUI directory of `ssh user@host` shortcuts. Port of charmbracelet/wishlist. Loads endpoints from YAML/JSON, renders an interactive picker, then `exec`s into the chosen ssh client (with full host-key prompt / agent forwarding fidelity).

10PHP

Since Jun 30Pushed 3w agoCompare

[ Source](https://github.com/sugarcraft/sugar-wishlist)[ Packagist](https://packagist.org/packages/sugarcraft/sugar-wishlist)[ RSS](/packages/sugarcraft-sugar-wishlist/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependenciesVersions (1)Used By (0)

[![sugar-wishlist](.assets/icon.png)](.assets/icon.png)

SugarWishlist
=============

[](#sugarwishlist)

[![CI](https://github.com/detain/sugarcraft/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/detain/sugarcraft/actions/workflows/ci.yml)[![codecov](https://camo.githubusercontent.com/224cdf5e0a7c24c4a09aac370745c2b24662236155187b5625ff7c895059549e/68747470733a2f2f636f6465636f762e696f2f67682f64657461696e2f737567617263726166742f6272616e63682f6d61737465722f67726170682f62616467652e7376673f666c61673d73756761722d776973686c697374)](https://app.codecov.io/gh/detain/sugarcraft?flags%5B0%5D=sugar-wishlist)[![Packagist Version](https://camo.githubusercontent.com/71b673ab9440d2535af4b153e08cf6b4b33b884c58e2d16e2932c1a840914555/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f737567617263726166742f73756761722d776973686c6973743f6c6162656c3d7061636b6167697374)](https://packagist.org/packages/sugarcraft/sugar-wishlist)[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE)[![PHP](https://camo.githubusercontent.com/e78ffc83837c0d12647811a7fd1910c3cbeae04988de94bb4fd5b67e0874696a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d254532253839254135382e312d3838393262662e737667)](https://www.php.net/)

[![demo](.vhs/picker.gif)](.vhs/picker.gif)

PHP port of [`charmbracelet/wishlist`](https://github.com/charmbracelet/wishlist) — a TUI directory of SSH endpoints. Launch `wishlist`, pick a host, hit Enter, and the current process is replaced with `ssh` connecting to it.

```
── wishlist ──
filter:
▸ production  ─  deploy@prod.example.com:2222
  staging     ─  stage.example.com
  dev         ─  dev.example.com

  ↑/↓ select · Enter connect · Esc quit · type to filter

```

Install
-------

[](#install)

The wishlist binary lives at `bin/wishlist`. Composer adds it to your global `vendor/bin/` when installed as a project dependency, or you can add the repo's `bin/` to your `$PATH`.

```
composer require sugarcraft/sugar-wishlist
~/.composer/vendor/bin/wishlist
```

Configure
---------

[](#configure)

`wishlist` looks for, in order:

1. `--config ` (CLI flag)
2. `~/.config/wishlist.yml`
3. `~/.config/wishlist.yaml`
4. `~/.config/wishlist.json`
5. `wishlist.{yml,yaml,json}` in the current directory

### YAML

[](#yaml)

```
- name: production
  host: prod.example.com
  port: 2222
  user: deploy
  identity_file: ~/.ssh/prod-deploy

- name: staging
  host: stage.example.com
  user: deploy

- name: jumpbox
  host: bastion.example.com
  options:
    - ServerAliveInterval=30
    - ProxyJump=gw.example.com
```

### JSON

[](#json)

```
[
  { "name": "production", "host": "prod.example.com", "port": 2222, "user": "deploy" },
  { "name": "staging",    "host": "stage.example.com" }
]
```

Keybindings
-----------

[](#keybindings)

KeyAction↑ / kMove up↓ / jMove downEnterConnect to highlighted endpointEsc / ^CQuit without connecting(typing)Type-to-filter; Backspace clearsImplementation
--------------

[](#implementation)

The picker is a tiny standalone widget — not a full SugarBits `List`. The lifecycle is

```
read config → render picker → read keys → choose → pcntl_exec(ssh, argv)

```

That last `pcntl_exec` is the critical line: it **replaces** the PHP process with `ssh`. File descriptors, environment, and the controlling tty all flow through unchanged, so the user sees a normal `ssh` session — host-key prompts, agent forwarding, MOTD, exit status, all native. We never proxy bytes; we get out of the way.

Programmatic use
----------------

[](#programmatic-use)

```
use SugarCraft\Wishlist\Config;
use SugarCraft\Wishlist\Picker;
use SugarCraft\Wishlist\Launcher;

$endpoints = Config::load('/etc/wishlist.yml');
$picked    = (new Picker())->pick($endpoints);
if ($picked !== null) {
    (new Launcher())->dispatch($picked);
}
```

Import from SSH Config
----------------------

[](#import-from-ssh-config)

`wishlist` can import endpoints directly from your OpenSSH config file (`~/.ssh/config`):

```
use SugarCraft\Wishlist\Config;

$endpoints = Config::importFromSshConfig('/home/user/.ssh/config');
```

The parser handles:

SSH Config KeyEndpoint Field`Host ``name``HostName ``host``User ``user``Port ``port``IdentityFile ``identityFiles[]``ProxyJump ``proxyJump``Host *` global defaults are inherited by all subsequent host blocks. Host patterns are used as the endpoint name (when no `HostName` is specified, the pattern itself becomes the host).

Programmatic Use
----------------

[](#programmatic-use-1)

```
use SugarCraft\Wishlist\Config;
use SugarCraft\Wishlist\Picker;
use SugarCraft\Wishlist\Launcher;

$endpoints = Config::load('/etc/wishlist.yml');
$picked    = (new Picker())->pick($endpoints);
if ($picked !== null) {
    (new Launcher())->dispatch($picked);
}

// Or import from SSH config:
$sshEndpoints = Config::importFromSshConfig('/home/user/.ssh/config');
```

Shared foundations
------------------

[](#shared-foundations)

sugar-wishlist uses [candy-fuzzy](https://github.com/detain/sugarcraft#candy-fuzzy) — `SmithWatermanMatcher::matchAll()` replaces ad-hoc `str_contains`-style filtering. The picker now surfaces scored ranking and match-highlight indices (ANSI bold+cyan on matched grapheme clusters) for ranked, highlighted filter results.

Status
------

[](#status)

Phase 10.28 — SSH config import. 69 tests / 176 assertions. Endpoint, Config (JSON + flat-YAML + SSH config), Picker, Launcher, SshConfigParser are all covered.

###  Health Score

21

—

LowBetter than 17% of packages

Maintenance62

Regular maintenance activity

Popularity2

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

Top contributor holds 99.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/b1036e0717211b8030b83cbe729e8ba6ba442fdbd5285fb97a39d7dcfe339342?d=identicon)[detain](/maintainers/detain)

---

Top Contributors

[![detain](https://avatars.githubusercontent.com/u/1364504?v=4)](https://github.com/detain "detain (105 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")

---

Tags

authorized-keyscandycorecharmcharmbraceletconnection-managerdirectoryendpoint-managerhost-pickerjson-configjump-hostpickerproxyjumpsshssh-configssh-launchertuiwishlistwishlist-portyaml-config

### Embed Badge

![Health badge](/badges/sugarcraft-sugar-wishlist/health.svg)

```
[![Health](https://phpackages.com/badges/sugarcraft-sugar-wishlist/health.svg)](https://phpackages.com/packages/sugarcraft-sugar-wishlist)
```

###  Alternatives

[josh-taylor/sage-svg

WordPress package to enable a blade directive to use SVG images inline with Sage 9

1846.3k](/packages/josh-taylor-sage-svg)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)