mirror of
https://github.com/ivuorinen/a.git
synced 2026-01-26 11:34:07 +00:00
106 lines
2.2 KiB
Markdown
106 lines
2.2 KiB
Markdown
# A CLI Wrapper for Age Encryption
|
|
|
|
A robust command-line interface (CLI) wrapper around the [age](https://github.com/FiloSottile/age)
|
|
encryption tool. This utility simplifies encryption and decryption using SSH keys,
|
|
with integrated support for fetching public keys from GitHub.
|
|
|
|
## Features
|
|
|
|
* **Secure Encryption/Decryption:** Utilize SSH and GitHub keys with `age` for strong encryption.
|
|
* **Configuration:** Easily configurable via a YAML file.
|
|
* **Structured Logging:** JSON-formatted logs with configurable paths.
|
|
* **Cross-platform:** Supports Linux, macOS, and Windows.
|
|
* **Shell Completion:** Auto-generated completion scripts for Bash, Zsh, and Fish.
|
|
* **Robust Error Handling:** Comprehensive and clear error messaging.
|
|
|
|
## Installation
|
|
|
|
### Prerequisites
|
|
|
|
* Go (1.21+)
|
|
* `age` encryption tool
|
|
|
|
### Build from source
|
|
|
|
```bash
|
|
git clone <repository-url>
|
|
cd <repository-directory>
|
|
go build -o a
|
|
```
|
|
|
|
### Move binary to path (optional)
|
|
|
|
```bash
|
|
sudo mv a /usr/local/bin/
|
|
```
|
|
|
|
## Usage
|
|
|
|
### Basic usage
|
|
|
|
```bash
|
|
a [command] [flags]
|
|
```
|
|
|
|
### Commands
|
|
|
|
* `config`: Manage application settings
|
|
* `encrypt`: Encrypt files
|
|
* `decrypt`: Decrypt files
|
|
* `completion`: Generate shell completion scripts
|
|
|
|
### Examples
|
|
|
|
#### Configure the CLI
|
|
|
|
```bash
|
|
a config --ssh-key ~/.ssh/id_rsa --github-user yourusername --default-recipients ~/.ssh/id_rsa.pub --cache-ttl 120
|
|
```
|
|
|
|
#### Encrypt a file
|
|
|
|
```bash
|
|
a encrypt -o encrypted_file.txt input.txt
|
|
```
|
|
|
|
#### Decrypt a file
|
|
|
|
```bash
|
|
a decrypt -o decrypted_file.txt encrypted_file.txt
|
|
```
|
|
|
|
## Generate shell completions
|
|
|
|
```bash
|
|
a completion bash > /etc/bash_completion.d/a
|
|
```
|
|
|
|
## Configuration File
|
|
|
|
Configuration is stored at `$HOME/.config/a/config.yaml`:
|
|
|
|
```yaml
|
|
ssh_key_path: "/home/user/.ssh/id_rsa"
|
|
github_user: "yourusername"
|
|
default_recipients:
|
|
- "/home/user/.ssh/id_rsa.pub"
|
|
cache_ttl_minutes: 120
|
|
log_file_path: "/home/user/.state/a/cli.log"
|
|
```
|
|
|
|
## Logging
|
|
|
|
Structured JSON logs are written to a configurable log file (`cli.log`). Verbosity can be adjusted with the `-v` or `--verbose` flag.
|
|
|
|
## Testing
|
|
|
|
Run unit tests with:
|
|
|
|
```bash
|
|
go test ./...
|
|
```
|
|
|
|
## License
|
|
|
|
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
|