Repository navigation
Releases: yxpil/ADONWORD
Releases · yxpil/ADONWORD
Release list
v0.2.0
ADONWORD v0.1.0
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_DIRenv 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.