agentuity-cli-auth-ssh-add
Add an SSH public key to your account (reads from file or stdin). Requires authentication. Use for managing authentication credentials
When & Why to Use This Skill
The agentuity-cli-auth-ssh-add skill enables users to securely add SSH public keys to their accounts via a command-line interface. By supporting multiple input methods such as local files and standard input (stdin), it streamlines the management of authentication credentials, ensuring secure access control and efficient identity management for developers and automated workflows.
Use Cases
- Developer Environment Setup: Quickly upload a local SSH public key (e.g., id_ed25519.pub) to a new account to establish secure remote access.
- Automated CI/CD Pipelines: Programmatically add deployment keys during build processes to allow automated agents to interact with protected resources.
- Secure Credential Rotation: Enhance security by piping newly generated SSH keys directly into the account configuration, reducing the risk of manual handling errors.
| name | agentuity-cli-auth-ssh-add |
|---|---|
| description | Add an SSH public key to your account (reads from file or stdin). Requires authentication. Use for managing authentication credentials |
| version | "0.0.104" |
| license | Apache-2.0 |
| allowed-tools | "Bash(agentuity:*)" |
| command | "agentuity auth ssh add" |
| tags | "mutating creates-resource slow requires-auth" |
Auth Ssh Add
Add an SSH public key to your account (reads from file or stdin)
Prerequisites
- Authenticated with
agentuity auth login
Usage
agentuity auth ssh add [options]
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
--file |
string | Yes | - | File containing the public key |
Examples
Add SSH key interactively:
bunx @agentuity/cli auth ssh add
Add SSH key from file:
bunx @agentuity/cli auth ssh add --file ~/.ssh/id_ed25519.pub
Add deploy key from file:
bunx @agentuity/cli auth ssh add --file ./deploy_key.pub
Add SSH key from stdin:
cat ~/.ssh/id_rsa.pub | bunx @agentuity/cli auth ssh add
Output
Returns JSON object:
{
"success": "boolean",
"fingerprint": "string",
"keyType": "string",
"added": "number"
}
| Field | Type | Description |
|---|---|---|
success |
boolean | Whether the operation succeeded |
fingerprint |
string | SSH key fingerprint |
keyType |
string | SSH key type (e.g., ssh-rsa, ssh-ed25519) |
added |
number | Number of keys added |