Compare commits
No commits in common. "main" and "v0.1.1" have entirely different histories.
11
CHANGELOG.md
11
CHANGELOG.md
@ -6,17 +6,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|||||||
|
|
||||||
## [Unreleased]
|
## [Unreleased]
|
||||||
|
|
||||||
## [0.1.3] - 2025-07-06
|
|
||||||
|
|
||||||
### Added
|
|
||||||
- add readme license and more
|
|
||||||
|
|
||||||
## [0.1.2] - 2025-07-06
|
|
||||||
|
|
||||||
### Added
|
|
||||||
- add readme
|
|
||||||
- try again
|
|
||||||
|
|
||||||
## [0.1.1] - 2025-07-06
|
## [0.1.1] - 2025-07-06
|
||||||
|
|
||||||
### Added
|
### Added
|
||||||
|
@ -3,5 +3,5 @@ members = ["crates/*"]
|
|||||||
resolver = "2"
|
resolver = "2"
|
||||||
|
|
||||||
[workspace.package]
|
[workspace.package]
|
||||||
version = "0.1.3"
|
version = "0.1.1"
|
||||||
license = "MIT"
|
license = "MIT"
|
||||||
|
171
README.md
171
README.md
@ -1,171 +0,0 @@
|
|||||||
# nossh
|
|
||||||
|
|
||||||
A lightning-fast SSH endpoint finder and launcher with fuzzy history lookup and ⬢ `.ssh/config` reference.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Features
|
|
||||||
|
|
||||||
- **Fuzzy history search**
|
|
||||||
Quickly fuzzy-find and re-run past `ssh` commands you’ve executed.
|
|
||||||
|
|
||||||
- **`.ssh/config` lookup**
|
|
||||||
Instantly search host entries from your `~/.ssh/config`.
|
|
||||||
|
|
||||||
- **Interactive mode**
|
|
||||||
Presents a searchable list of endpoints for one-shot selection.
|
|
||||||
|
|
||||||
- **External invocation**
|
|
||||||
Falls back to standard `ssh` when provided arguments.
|
|
||||||
|
|
||||||
- **Configurable config path**
|
|
||||||
Override the default `~/.ssh/config` via an `--ssh-config-path` flag or `SSH_CONFIG_PATH` env var.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Installation
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cargo install nossh
|
|
||||||
````
|
|
||||||
|
|
||||||
Or build from source:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git clone https://github.com/yourorg/nossh.git
|
|
||||||
cd nossh
|
|
||||||
cargo build --release
|
|
||||||
cp target/release/nossh /usr/local/bin/
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Quickstart
|
|
||||||
|
|
||||||
1. **Launch interactive search**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
nossh
|
|
||||||
```
|
|
||||||
|
|
||||||
* Fuzzy-find against:
|
|
||||||
|
|
||||||
* Your cached history of `ssh …` commands.
|
|
||||||
* Host entries in your `~/.ssh/config`.
|
|
||||||
|
|
||||||
2. **Run a past command or config entry**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Start typing “git.fr” and press Enter:
|
|
||||||
$ nossh
|
|
||||||
1. ratchet:22
|
|
||||||
2. somegateway:222
|
|
||||||
# 3. git.front.kjuulh.io
|
|
||||||
> git.fr
|
|
||||||
# then Enter runs:
|
|
||||||
ssh git.front.kjuulh.io
|
|
||||||
```
|
|
||||||
|
|
||||||
3. **Direct `ssh` passthrough**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
nossh user@host -p 2222
|
|
||||||
```
|
|
||||||
|
|
||||||
Behaves exactly like `ssh …`; also logs the invocation for future fuzzy lookup.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Usage
|
|
||||||
|
|
||||||
```text
|
|
||||||
nossh [--ssh-config-path <path>] [<ssh-args>...]
|
|
||||||
```
|
|
||||||
|
|
||||||
| Option | Description |
|
|
||||||
| ------------------------ | ---------------------------------------------------------------------------------------------- |
|
|
||||||
| `--ssh-config-path PATH` | Path to your SSH `config` file (default: `~/.ssh/config`). Overrides `SSH_CONFIG_PATH` env var |
|
|
||||||
| `<ssh-args>…` | If provided, forwarded to `ssh` as normal. |
|
|
||||||
|
|
||||||
### Environment
|
|
||||||
|
|
||||||
* `SSH_CONFIG_PATH`
|
|
||||||
Alternative way to point to your SSH config:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
export SSH_CONFIG_PATH="/custom/path/config"
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Configuration
|
|
||||||
|
|
||||||
The default SSH config path is `${HOME}/.ssh/config`. If that file is missing or you wish to use a different config, set the flag or env var:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
nossh --ssh-config-path /mnt/shared/ssh_config
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## How It Works
|
|
||||||
|
|
||||||
1. **Startup**
|
|
||||||
|
|
||||||
* Reads `~/.ssh/config` (or your override).
|
|
||||||
* Loads your SSH‐command history database (`~/.local/share/nossh/db.sqlite3`).
|
|
||||||
|
|
||||||
2. **Interactive Mode**
|
|
||||||
|
|
||||||
* Presents a fuzzy prompt (via `fzf`-style) combining:
|
|
||||||
|
|
||||||
* Host patterns from config.
|
|
||||||
* Host strings from history (e.g. `user@host -p 2222`).
|
|
||||||
|
|
||||||
3. **Selection**
|
|
||||||
|
|
||||||
* On Enter, launches `ssh` with the selected arguments.
|
|
||||||
* In external (non-interactive) mode, simply proxies `ssh …` and appends to history.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Examples
|
|
||||||
|
|
||||||
* **Basic interactive**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
nossh
|
|
||||||
```
|
|
||||||
|
|
||||||
* **Forced interactive**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
nossh interactive
|
|
||||||
```
|
|
||||||
|
|
||||||
* **One-liner passthrough**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
nossh -i ~/.ssh/id_ed25519 root@example.com
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Development
|
|
||||||
|
|
||||||
Clone and run tests:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git clone https://github.com/kjuulh/nossh.git
|
|
||||||
cd nossh
|
|
||||||
cargo test
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## License
|
|
||||||
|
|
||||||
MIT-licensed
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
@ -1,12 +1,8 @@
|
|||||||
[package]
|
[package]
|
||||||
name = "nossh"
|
name = "nossh"
|
||||||
|
version = "0.1.0"
|
||||||
edition = "2024"
|
edition = "2024"
|
||||||
readme = "../../README.md"
|
|
||||||
version.workspace = true
|
|
||||||
license.workspace = true
|
|
||||||
repository = "https://git.front.kjuulh.io/kjuulh/nossh"
|
|
||||||
authors = ["kjuulh <contact@kasperhermansen.com>"]
|
|
||||||
description = "A SSH endpoint finder and launcher with fuzzy history lookup and ⬢ `.ssh/config` reference."
|
|
||||||
|
|
||||||
[dependencies]
|
[dependencies]
|
||||||
anyhow = "1.0.98"
|
anyhow = "1.0.98"
|
||||||
|
@ -6,9 +6,6 @@ vars:
|
|||||||
service: "nossh"
|
service: "nossh"
|
||||||
registry: kasperhermansen
|
registry: kasperhermansen
|
||||||
|
|
||||||
rust:
|
|
||||||
publish: {}
|
|
||||||
|
|
||||||
please:
|
please:
|
||||||
project:
|
project:
|
||||||
owner: kjuulh
|
owner: kjuulh
|
||||||
@ -18,3 +15,4 @@ please:
|
|||||||
api_url: "https://git.front.kjuulh.io"
|
api_url: "https://git.front.kjuulh.io"
|
||||||
actions:
|
actions:
|
||||||
rust:
|
rust:
|
||||||
|
publish: true
|
||||||
|
@ -1,3 +0,0 @@
|
|||||||
{
|
|
||||||
"$schema": "https://docs.renovatebot.com/renovate-schema.json"
|
|
||||||
}
|
|
Loading…
x
Reference in New Issue
Block a user