Crates.io | ssh-agency |
lib.rs | ssh-agency |
version | 0.1.0 |
source | src |
created_at | 2023-07-27 14:52:30.642042 |
updated_at | 2023-07-27 14:52:30.642042 |
description | CLI helping you manage SSH agents when they get gnarly |
homepage | |
repository | https://github.com/tarsir/agency |
max_upload_size | |
id | 927497 |
size | 45,057 |
ssh-agency
is a manager for SSH agents (similar to ssh-ident
or keychain
) that:
CLI helping you manage SSH agents when they get gnarly
Usage: ssh-agency [OPTIONS]
Options:
-n, --reduce_count Consolidate to one agent by number of registered identities
-r, --reduce Consolidate to one agent with no particular method
-s, --show-agents Show the currently running agents
-y, --ez Ez mode that non-interactively guarantees an agent when exactly 1 or 0 agents are running
-p, --purge Purge agents that have no identities registered
-h, --help Print help
-V, --version Print version
In all options, ssh-agency
will clear agents that have lingering socket paths but
no process (dead agents).
Run without options, ssh-agency
will start an interactive dialog to let the user
clear the running agents without registered identities, and pick an agent to
print the export
statements to enable the agent in the current environment.
-n/--reduce_count
: Consolidate by number of identitiesRemoves and cleans up all running agents except the agent with the highest number of registered identities.
-r/--reduce
: Consolidate at randomRemoves and cleans up all running agents except one, with no particular method of determining the survivor.
-s/--show-agents
: Show running agentsShows all the running agents and the number of identities registered to each.
-y/--ez
: Non-interactive "easy" modeThe "ez" mode is intended to be a scriptable drop-in replacement for tools like
ssh-ident or
keychain. In this mode, ssh-agency
will:
export
statements to enable the agent in the current environment.This option is best used in a scripting scenario or as part of your shell startup to connect to a running agent if one exists from a previous terminal session, or create a new one for initial sessions.
-p/--purge
: Purge all identity-less agentsRemoves and cleans up all running agents that do not have registered identities.