Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hadenlabs/zsh-ssh

Search ssh connect
https://github.com/hadenlabs/zsh-ssh

assh hadenlabs peru plugins ssh tools zsh

Last synced: about 1 month ago
JSON representation

Search ssh connect

Host: GitHub
URL: https://github.com/hadenlabs/zsh-ssh
Owner: hadenlabs
License: lgpl-3.0
Created: 2018-12-25T20:24:00.000Z (about 6 years ago)
Default Branch: develop
Last Pushed: 2023-03-04T07:42:58.000Z (almost 2 years ago)
Last Synced: 2024-04-16T01:33:18.811Z (9 months ago)
Topics: assh, hadenlabs, peru, plugins, ssh, tools, zsh
Language: Makefile
Homepage:
Size: 5.26 MB
Stars: 4
Watchers: 3
Forks: 1
Open Issues: 9
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: docs/code_of_conduct.md

Awesome Lists containing this project

README

[![Latest Release](https://img.shields.io/github/release/hadenlabs/zsh-ssh)](https://github.com/hadenlabs/zsh-ssh/releases) [![Lint](https://img.shields.io/github/workflow/status/hadenlabs/zsh-ssh/lint-code)](https://github.com/hadenlabs/zsh-ssh/actions) [![Issues](https://img.shields.io/github/issues/hadenlabs/zsh-ssh)](https://github.com/hadenlabs/zsh-ssh/issues) [![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow)](https://conventionalcommits.org) [![KeepAChangelog](https://img.shields.io/badge/Keep%20A%20Changelog-1.0.0-%23E05735)](https://keepachangelog.com) [![Beacon](https://ga-beacon.appspot.com/G-MZEK48EGE8/zsh-ssh/readme)](https://github.com/hadenlabs/zsh-ssh)

# zsh-ssh

zsh-ssh implement assh plugin for zsh.

## Requirements

This is a list of plugins that need to be installed previously to enjoy all the goodies of this configuration:

- [zsh-core](https://github.com/hadenlabs/zsh-core)

## Installation

### [oh-my-zsh](https://github.com/robbyrussell/oh-my-zsh) users

If you're using [oh-my-zsh](https://gitub.com/robbyrussell/oh-my-zsh), install this plugin by doing the following:

1. Go to your oh-my-zsh custom plugins directory -`cd ~/.oh-my-zsh/custom/plugins`
2. Clone the plugin `bash git clone https://github.com/hadenlabs/zsh-ssh`bash
3. Edit your `.zshrc` and add `plugins=( ... zsh-ssh )` to your list of plugins
4. Open a new terminal and enjoy!

### [antigen](https://github.com/zsh-users/antigen) users

If you're using [Antigen](https://github.com/zsh-users/antigen), install this plugin by doing the following:

1. Add `antigen bundle hadenlabs/zsh-ssh` to your `.zshrc` where you're adding your other plugins.
2. Either open a new terminal to force zsh to load the new plugin, or run `antigen bundle hadenlabs/zsh-ssh` in a running zsh session.
3. Enjoy!

### [antibody](https://github.com/getantibody/antibody) users

If you're using [Antibody](https://github.com/getantibody/antibody), install this plugin by doing the following:

1. Add :

```{.sourceCode .bash}
antibody bundle hadenlabs/zsh-ssh
```

to your `.zshrc` where you're adding your other plugins.

2. Either open a new terminal to force zsh to load the new plugin, or run `antibody bundle hadenlabs/zsh-ssh` in a running zsh session.
3. Enjoy!

## Functions

zsh ssh includes a small utility `ssh` to fetch and install new packages.

#### `ssh::list`

list all of assh connects.

#### `ssh::build`

build the config ssh using assh.

#### `ssh::connect`

Allows you to search the list of assh hosts.

#### `ssh::sync`

Synchronizes the configurations that are in `conf/assh.yml`

## Related Projects

Check out these related projects.

- [moul/assh](https://github.com/moul/assh) - A transparent wrapper that adds support for regex

## References

For additional context, refer to some of these links.

- [gko/ssh-connect](https://github.com/gko/ssh-connect) - plugin reference ssh connect

## Help

**Got a question?**

File a GitHub [issue](https://github.com/hadenlabs/zsh-ssh/issues).

## Contributing

### Bug Reports & Feature Requests

Please use the [issue tracker](https://github.com/hadenlabs/zsh-ssh/issues) to report any bugs or file feature requests.

### Development

In general, PRs are welcome. We follow the typical "fork-and-pull" Git workflow.

1. **Fork** the repo on GitHub
2. **Clone** the project to your own machine
3. **Commit** changes to your own branch
4. **Push** your work back up to your fork
5. Submit a **Pull Request** so that we can review your changes

**NOTE:** Be sure to rebase the latest changes from "upstream" before making a pull request!

## Module Versioning

This Module follows the principles of [Semantic Versioning (SemVer)](https://semver.org/).

Using the given version number of `MAJOR.MINOR.PATCH`, we apply the following constructs:

1. Use the `MAJOR` version for incompatible changes.
1. Use the `MINOR` version when adding functionality in a backwards compatible manner.
1. Use the `PATCH` version when introducing backwards compatible bug fixes.

### Backwards compatibility in `0.0.z` and `0.y.z` version

- In the context of initial development, backwards compatibility in versions `0.0.z` is **not guaranteed** when `z` is increased. (Initial development)
- In the context of pre-release, backwards compatibility in versions `0.y.z` is **not guaranteed** when `y` is increased. (Pre-release)

## Copyright

## Trademarks

All other trademarks referenced herein are the property of their respective owners.

## License

The code and styles are licensed under the LGPL-3.0 license [See project license.](LICENSE).

## Don't forget to 🌟 Star 🌟 the repo if you like zsh-ssh

[Your feedback is appreciated](https://github.com/hadenlabs/zsh-ssh/issues)