sesh-ssh 0.2.0

A fast, minimal SSH connection manager for VPS hosts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147

# sesh

A fast, minimal SSH connection manager for VPS hosts. Store, tag, and connect to your servers from the command line.

## Installation

### From crates.io

```sh
cargo install sesh-ssh
```

### From source

Requires the Rust nightly toolchain.

```sh
git clone https://github.com/roushou/sesh.git
cd sesh
cargo install --path .
```

### From GitHub releases

Download a prebuilt binary from the [releases page](https://github.com/roushou/sesh/releases) and place it somewhere on your `PATH`.

## Quick start

```sh
# Import hosts from your SSH config
sesh import

# Connect (saves then connects)
sesh connect web-1 --host 203.0.113.10 --user root --port 2222 --tags prod,web --provider hetzner

# Connect to known host
sesh connect web-1

# List all hosts
sesh list
```

## Commands

### `sesh add <name>`

Add a host entry manually.

| Flag               | Description                          | Default |
| ------------------ | ------------------------------------ | ------- |
| `--host`           | Hostname or IP (required)            |         |
| `--user`           | SSH user                             |         |
| `--port`           | SSH port                             | `22`    |
| `--identity-file`  | Path to private key (`-i`)           |         |
| `--tags`           | Comma-separated tags                 |         |
| `--provider`       | Provider label (e.g. `hetzner`)      |         |

### `sesh edit <name>`

Edit an existing host entry.

| Flag                   | Description                                  | Default |
| ---------------------- | -------------------------------------------- | ------- |
| `--rename`             | Rename entry                                 |         |
| `--host`               | Update hostname or IP                        |         |
| `--user`               | Set SSH user                                 |         |
| `--clear-user`         | Remove SSH user                              |         |
| `--port`               | Update SSH port                              |         |
| `--identity-file`      | Set private key path (`-i`)                  |         |
| `--clear-identity-file`| Remove private key path                      |         |
| `--tags`               | Comma-separated tags (replaces all tags)     |         |
| `--clear-tags`         | Remove all tags                              |         |
| `--provider`           | Set provider label                           |         |
| `--clear-provider`     | Remove provider label                        |         |

### `sesh remove <name>`

Remove an existing host entry.

### `sesh import`

Import host entries from an SSH config file.

| Flag            | Description                                   | Default           |
| --------------- | --------------------------------------------- | ----------------- |
| `--file`        | Path to SSH config                            | `~/.ssh/config`   |
| `--overwrite`   | Replace existing entries with imported values  |                   |
| `--provider`    | Provider label for all imported entries        |                   |
| `--tags`        | Comma-separated tags for all imported entries  |                   |

### `sesh list`

List stored host entries in a table.

| Flag          | Description          |
| ------------- | -------------------- |
| `--tag`       | Filter by tag        |
| `--provider`  | Filter by provider   |

### `sesh connect <target>`

Connect using system `ssh`.

- If `<target>` matches a stored entry name, it connects directly.
- If `<target>` does not exist, you can auto-add and save in one command:
  - `sesh connect <name> --host <hostname>`
  - `sesh connect user@host` (saved under `host` unless `--save-as` is set)

| Flag            | Description                                                     | Default |
| --------------- | --------------------------------------------------------------- | ------- |
| `--host`        | Hostname/IP for one-command auto-add                            |         |
| `--user`        | SSH user for auto-add                                           |         |
| `--port`        | SSH port for auto-add                                           | `22`    |
| `--identity-file`| Private key path for auto-add (`-i`)                          |         |
| `--tags`        | Comma-separated tags for auto-add                               |         |
| `--provider`    | Provider label for auto-add                                     |         |
| `--save-as`     | Entry name to save auto-added destination under                 |         |
| `--dry-run`     | Print the SSH command without running                           |         |

### `sesh doctor [name]`

Run environment and host health checks. Verifies that `ssh` is available, the store file exists, and that hosts are reachable over TCP with a valid SSH banner.

| Flag             | Description                     | Default  |
| ---------------- | ------------------------------- | -------- |
| `--timeout-ms`   | TCP/banner timeout in ms        | `1500`   |

## Storage

Host entries are stored in `~/.config/sesh/hosts.toml`.

```toml
version = 1

[[hosts]]
name = "web-1"
host = "203.0.113.10"
user = "root"
port = 2222
identity_file = "/home/me/.ssh/id_ed25519"
tags = ["prod", "web"]
provider = "hetzner"
```

## License

MIT