Skip to content

Releases: yxpil/ADONWORD

v0.2.0

Choose a tag to compare

@github-actions github-actions released this 04 Sep 20:18
MCP: serve mode now speaks Streamable HTTP JSON-RPC (0.2.0) — status/…

ADONWORD v0.1.0

Choose a tag to compare

@yxpil yxpil released this 04 Sep 09:28

ADONWORD v0.1.0

Active-defense sentinel for AI agents around the BIT ecosystem — file-integrity baselines, suspicious-process monitoring and listening-port alerts. Observation + alerting only; it never kills processes.

面向 BIT 生态 AI 智能体的本机主动防御哨兵 —— 文件完整性基线、可疑进程监控、监听端口告警。只做观察 + 告警,绝不杀进程。

What's included / 包含内容

  • CLI (adonword): baseline update/check (sha256 file-integrity baseline, CI-friendly exit codes 0/1/2), scan (one full inspection → findings JSON), watch (daemon, 30s default interval, stderr alerts + webhook with 5-min dedup), report (last scan from state.json), serve (HTTP API on 127.0.0.1:8754)
  • HTTP API: GET /health, GET /report, POST /invoke (BIT Remote protocol: params.action = scan | baseline_check | report), optional Bearer token via --token
  • BIT integration: exec runtime (JSON over stdin, stdin wins), Remote tool (http://127.0.0.1:8754/invoke), plain REST
  • Config: TOML at ~/.adonword/adonword.toml (ADONWORD_DATA_DIR env override, -c/--config); watch paths with default excludes (target/, node_modules/, .git/), process blocklist/allowlist (glob, case-insensitive), port allowlist (single values + "8000-8100" ranges), optional webhook (10s timeout)
  • CI: build + test on ubuntu/macos/windows; release workflow attaches per-platform binaries (checksums produced by CI)
  • Tests: 14 unit tests + 8 integration tests, all green (baseline tamper/added/removed, port-range parsing, blocklist matching, scan findings, serve /health + /invoke + token auth)

Install / 安装

Download the asset for your platform from this release and put the adonword binary on your PATH:

Platform Asset
macOS Apple Silicon adonword-v0.1.0-aarch64-apple-darwin.tar.gz
macOS Intel adonword-v0.1.0-x86_64-apple-darwin.tar.gz
Linux x64 adonword-v0.1.0-x86_64-unknown-linux-gnu.tar.gz
Windows x64 adonword-v0.1.0-x86_64-pc-windows-msvc.zip
tar xzf adonword-v0.1.0-<target>.tar.gz
sudo mv adonword-v0.1.0-<target>/adonword /usr/local/bin/
adonword --version

从本 Release 下载对应平台资产,将 adonword 二进制放入 PATH 即可;或 cargo install --git https://github.com/yxpil/ADONWORD 从源码安装。校验和由 Release CI 生成,见下方 Assets。

Quick start / 快速上手

adonword baseline update          # build baseline / 构建基线
adonword baseline check           # exit 0 clean / 1 changed / 2 missing
adonword scan --json              # full inspection / 全量巡检
adonword watch --interval 30      # daemon + alerts / 守护 + 告警
adonword serve --port 8754        # HTTP API (BIT Remote)

Configuration reference, BIT tools.json snippets and the API table: see the README and the wiki.

配置参考、BIT tools.json 片段与 API 表:见 README 与 Wiki。


Part of the BIT ecosystem — agents watching over agents.