AkurAI-EC2 / README.md

Latest change 8fd2ab2c4d35f12420c1578debb442a5883d0f64 - chore: version akurai ec2 cli by Claude Code

# akurai-ec2

Version-controlled home for the AkurAI EC2 ops CLI that is installed locally as `~/.local/bin/akurai-ec2`.

## Purpose

This repo tracks the shared Bash CLI used to operate the AkurAI AWS platform box at `mail.olibuijr.com`. It versions the script itself, plus the local installer used to place it back into `~/.local/bin/`.

## Host assumptions

- Local host has Bash, `git`, `ssh`, `scp`, and standard coreutils.
- SSH access to the target box works through the `akurai-mail` alias in `~/.ssh/config`, or via `AKURAI_EC2_SSH=<host>`.
- The remote host is an Ubuntu-style system with `systemd`, `sudo`, `nginx`, `certbot`, and the AkurAI app layout expected by the script.
- The ports registry defaults to `~/.claude/skills/_VMPORTS/ports.registry` unless `AKURAI_PORTS_REGISTRY` overrides it.

## Install

Default install uses a symlink so the tracked repo copy stays authoritative:

```bash
./install.sh
```

Optional copy install:

```bash
./install.sh --copy
```

The installer targets `~/.local/bin/akurai-ec2` by default and preserves executable mode.

## Release engine note

`akurai-ec2 release` is the shared release engine for AkurAI app repos. It reads each app repo's `akurai-deploy.toml`, handles version/changelog/tag flow, and then performs the EC2 deploy path. This repo only versions the shared CLI; per-app release manifests stay in their own repos.

## Verification

```bash
bash -n bin/akurai-ec2
bash -n install.sh
./bin/akurai-ec2 --help
./install.sh --dry-run
```