Skip to content

0.4.0 - 2026-09-11

Choose a tag to compare

@github-actions github-actions released this 11 Sep 09:23
2348b73

Release Notes

Added

  • Interactive sessions: airlok with no task opens a REPL with a <model> <dir>> prompt, /help, /clear, /compact, /cost, /redactions, /config, and /exit. Ctrl-C cancels the turn in progress and keeps the partial reply marked as interrupted; Ctrl-D saves and quits.
  • Sessions are saved after every turn under $XDG_DATA_HOME/airlok/sessions/<dir hash>/ (~/.local/share/airlok by default), mode 0600 in a 0700 directory, with the config snapshot, provider and model, plaintext history, redaction map, token counts, and timestamps. The provider API key is stored blank. --resume continues the latest session for the directory (--resume=<id> a particular one), rebuilding the context block and adding a system note with the resume time. airlok sessions lists them, sessions rm <id> deletes one, sessions clean --older-than 30d prunes every directory.
  • Compaction: once the last request used more than [agent] compact_at (0.75) of [provider] context_window (200k), the next turn replaces everything but the last [agent] keep_recent_turns (4) turns with a model-written summary, requested through the redactor with no tools. Shown as a dim compacted: X -> Y tokens line and recorded in the session.
  • Token usage from both providers: Anthropic message_start/message_delta counts, OpenAI stream_options.include_usage. Where a provider reports none, requests are estimated at chars/4 and /cost says so.

Changed

  • A turn that fails or is aborted no longer leaves its prompt in the history.

Install airlok 0.4.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/airlok-dev/airlok/releases/download/v0.4.0/airlok-installer.sh | sh

Install prebuilt binaries via Homebrew

brew install airlok-dev/tap/airlok

Install prebuilt binaries into your npm project

npm install airlok@0.4.0

Download airlok 0.4.0

File Platform Checksum
airlok-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
airlok-x86_64-apple-darwin.tar.xz Intel macOS checksum
airlok-aarch64-unknown-linux-gnu.tar.xz ARM64 Linux checksum
airlok-x86_64-unknown-linux-gnu.tar.xz x64 Linux checksum