susshi 0.15.8

A modern terminal-based SSH connection manager with a beautiful Catppuccin TUI
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

# Import and Export

## Import from OpenSSH Config

Generate susshi YAML from an existing `~/.ssh/config`:

```bash
susshi --import-ssh-config
susshi --import-ssh-config --dry-run                        # preview without writing
susshi --import-ssh-config --output ~/.susshi.yml           # write to specific file
susshi --import-ssh-config --ssh-config-path ~/work/.ssh/config
```

Behavior:

- Recursive `Include` directives are followed.
- `ProxyJump` entries are converted to jump-mode configuration.
- The output is printed to stdout unless `--output` is specified.

## List Servers as JSON

Print all resolved servers as a JSON array — ready for `jq` or `fzf` pipelines:

```bash
susshi --list
susshi --list --list-filter "web"
susshi --list --list-filter "#prod"
```

Each object contains: `name`, `host`, `user`, `port`, `group`, `env`, `namespace`, `tags`, `mode`.

Example pipelines:

```bash
# Pick a server with fzf and connect
susshi --list | jq -r '.[].name' | fzf | xargs -I{} susshi --direct {}

# Show all hostnames tagged prod
susshi --list --list-filter "#prod" | jq -r '.[].host'
```

## Export Inventory

All export commands support `--export-filter` with the same text and `#tag` syntax as the TUI search bar. Output goes to stdout unless `--export-output <file>` is specified.

### Ansible

```bash
susshi --export ansible
susshi --export ansible --export-output ~/inventory.yml
susshi --export ansible --export-filter "#prod"
```

Produces a standard Ansible YAML inventory with groups mapped from susshi groups and environments.

### Terraform

```bash
susshi --export terraform
susshi --export terraform --export-output inventory.json
susshi --export terraform --export-filter "#prod"
```

Produces a JSON file loadable with `jsondecode(file(...))`:

```hcl
locals {
  susshi = jsondecode(file("${path.module}/inventory.json"))
}

resource "null_resource" "ping" {
  for_each = { for s in local.susshi.servers : s.name => s }
  # each.value.host, each.value.user, each.value.port, …
}
```

### Nmap / masscan

```bash
susshi --export nmap
susshi --export nmap --export-output targets.txt
susshi --export nmap --export-filter "#prod"

nmap -iL targets.txt -p 22 -sV
masscan -iL targets.txt -p 22
```

### CSV

Columns: `name`, `host`, `user`, `port`, `ssh_key`, `group`, `env`, `namespace`, `tags`, `notes`.

```bash
susshi --export csv
susshi --export csv --export-output ~/servers.csv
susshi --export csv --export-filter "#prod"
```

Fields with commas, double-quotes, or newlines are quoted per RFC 4180. Multiple tags are joined with `;`.

### OpenSSH Config

Exports servers as `Host` blocks compatible with `~/.ssh/config`:

```bash
susshi --export openssh
susshi --export openssh --export-output ~/.ssh/config.d/susshi
susshi --export openssh --export-filter "#prod"
```

Each server produces a `Host` block with `HostName`, `User`, `Port` (if not 22), `IdentityFile`, `ProxyJump` (jump mode), and `IdentityAgent` (if `ssh_agent_sock` is set). Wallix servers are exported as direct blocks — their bastion routing is not representable in standard SSH config.