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/

mekabox

scripts/mekabox runs the meka installed on the host inside a stock archlinux:latest container, with no image of its own to build or pull: the binary is bind-mounted in, ~/.config/meka read-only, and ~/.local/share/meka writable, since that is where meka.db keeps every session and credential. The agent starts at unrestricted with instructions saying it may install whatever the task needs, and that it must not create memories or scheduled jobs unless asked, since the store it writes is the host’s. It is the answer to “let it do anything, just not to my machine”: the container is disposable and the host config cannot be written. 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