Installation

meka is written in Rust and builds as a single binary.

Pre-Built Binaries

Download the latest release for your platform from the GitHub Releases page.

Extract the binary and place it somewhere on your $PATH:

# Linux/macOS
tar -xzf meka-*.tar.gz
cp meka ~/.local/bin/

Container

Every tagged release publishes an image to the GitHub Container Registry:

docker run --rm -it ghcr.io/k4yt3x/meka:latest --help

The image carries the binary and nothing else, so a session inside it starts with no config and no database. Mount both to reach an existing setup:

docker run --rm -it \
    -v ~/.config/meka:/root/.config/meka:ro \
    -v ~/.local/share/meka:/root/.local/share/meka:rw \
    ghcr.io/k4yt3x/meka:latest

The data directory has to be writable: it holds meka.db, which is where sessions and every credential live.

mekabox

contrib/container/mekabox does that mounting for you, against a stock archlinux:latest with your host binary bind-mounted in, and starts the agent at unrestricted with instructions saying it may install whatever the task needs. It is the answer to “let it do anything, just not to my machine”: the container is disposable and the host config is mounted read-only. It picks podman over docker when both are present.

Cargo Install

If you have Rust installed, you can install meka directly from the Git repository:

cargo install --locked --git https://github.com/k4yt3x/meka.git

This builds the latest version from source and installs it to ~/.cargo/bin/.

Building from Source

Prerequisites

• Rust 1.95 or newer, the version Cargo.toml declares
• A C compiler (for the bundled SQLite)

Build

git clone https://github.com/k4yt3x/meka.git
cd meka
cargo build --release

The binary will be at target/release/meka. Copy it somewhere on your $PATH:

cp target/release/meka ~/.local/bin/

Verify

meka --version
meka --help