Installation
Install aka on macOS, Linux or Windows.
curl -fsSL https://aka.visvesh.dev/install.sh | shThe script downloads the latest release for your machine, checks its SHA-256 checksum, and installs aka into ~/.local/bin. Set AKA_INSTALL_DIR to choose another directory, or AKA_VERSION to pin a version:
curl -fsSL https://aka.visvesh.dev/install.sh | AKA_VERSION=v0.1.1 shThe same script is in the repository, at https://raw.githubusercontent.com/visveshkhanna/aka/main/install.sh.
Set up HTTPS
aka serves every app over HTTPS from a local certificate authority. Trust it once, so browsers accept the certificates:
aka trustmacOS and Windows ask you to confirm; Linux runs sudo. The CA can only sign .localhost and loopback names, so it cannot be used to impersonate other sites. See HTTPS.
Check the setup
aka doctordoctor checks the proxy, the certificate authority, name resolution and every route, and says how to fix anything that is wrong.
Verify a download
Every release lists its archives in checksums.txt, and each archive has a build provenance attestation from the release workflow:
gh attestation verify aka_0.1.1_linux_amd64.tar.gz --repo visveshkhanna/akaUninstall
aka service uninstall # if you installed the login service
aka proxy stop
aka untrust # remove the CA from the trust store
rm -rf ~/.aka # the CA, aliases and logs
rm "$(command -v aka)"