v0.3.0

Neton v0.3.0

v0.2.0

feat: authorized LAN scanning — arp, netscan, portscan, device (v0.2.0)

New commands (TCP-connect only, no root, gated behind an explicit
authorization acknowledgement):

- arp: system ARP/neighbor table (macOS/Linux/Windows parsers) with
  embedded OUI vendor lookup; read-only, no acknowledgement needed
- netscan <CIDR>: subnet device discovery via concurrent TCP sweep
  correlated with the ARP table (via: tcp/arp)
- portscan <TARGET>: TCP connect scan with common/list/range port specs
- device <IP>: per-device analysis — MAC vendor, reverse-DNS hostname,
  open ports, HTTP(S) fingerprint (Server header, <title>) and an
  informational device-type guess

Authorization model: CLI flag --yes-i-have-permission or env
NETON_I_HAVE_PERMISSION=yes (exit code 2 without it); serve mode only
exposes the scan actions when started with the same acknowledgement and
answers HTTP 403 otherwise. /invoke-actions lists all 11 actions.

Also fixes two latent bugs caught by tests: the minimal DNS client
rejected every response (inverted QR-bit check) and sent a malformed
11-byte header; and MAC normalization dropped macOS `arp` output where
leading zeros are omitted per group.

Neton v0.1.0

Neton v0.1.0

First release of Neton — structured local network observation & diagnostics for AI agents, part of the BIT ecosystem.

English

What's included

• CLI (neton, all output JSON, --pretty supported, piped-stdin JSON merged over args):
  • info — hostname, OS, arch, default outbound IP (UDP-connect probe, zero packets sent)
  • interfaces — name, IPv4/IPv6, MAC, best-effort status
  • ports — listening TCP + bound UDP sockets with pid / process name (--pid filter)
  • dns — system resolver lookup with IPv4/IPv6 arrays and elapsed ms
  • ping — TCP connect probe (no ICMP, no root)
  • probe — concurrent TCP probing of host:port targets (thread pool, default concurrency 32)
  • http — request summary: status, timing, headers (sensitive ones redacted to length), body preview
  • serve — BIT Remote HTTP API on 127.0.0.1:8753 (GET /health, GET /invoke-actions, POST /invoke, optional --token Bearer auth)
• 42 tests (unit + CLI/serve integration), CI on Linux/macOS/Windows, release workflow attaching platform binaries.
• Apache-2.0 licensed. Observation/diagnostics only — no offensive features.

Install

Platform	Asset
Linux x86_64	neton-v0.1.0-x86_64-unknown-linux-gnu.tar.gz
macOS Apple Silicon	neton-v0.1.0-aarch64-apple-darwin.tar.gz
Windows x86_64	neton-v0.1.0-x86_64-pc-windows-msvc.zip

tar xzf neton-v0.1.0-aarch64-apple-darwin.tar.gz
sudo mv neton /usr/local/bin/
neton --version

Checksums (.sha256) are attached by CI. Build from source: cargo install --git https://github.com/yxpil/Neton.

中文

内容概览

• 命令行（neton，全部输出 JSON，支持 --pretty，管道 stdin JSON 合并覆盖参数）：
  • info — 主机名、操作系统、架构、默认出口 IP（UDP connect 探测，不发流量）
  • interfaces — 网卡名称、IPv4/IPv6、MAC、状态
  • ports — TCP 监听 + UDP 绑定套接字，含 pid / 进程名（支持 --pid 过滤）
  • dns — 系统解析，返回 IPv4/IPv6 数组与耗时
  • ping — TCP 连接探测（非 ICMP，无需 root）
  • probe — 并发批量 TCP 探活（线程池，默认并发 32）
  • http — 请求概要：状态码、耗时、响应头（敏感头脱敏为长度）、body 预览
  • serve — BIT Remote HTTP API，默认 127.0.0.1:8753（GET /health、GET /invoke-actions、POST /invoke，可选 --token Bearer 鉴权）
• 42 个测试（单元 + CLI/serve 集成），Linux/macOS/Windows 三平台 CI，release 工作流自动附加平台二进制。
• Apache-2.0 协议。只做观测与诊断，无任何攻击特性。

安装

平台	文件
Linux x86_64	neton-v0.1.0-x86_64-unknown-linux-gnu.tar.gz
macOS Apple Silicon	neton-v0.1.0-aarch64-apple-darwin.tar.gz
Windows x86_64	neton-v0.1.0-x86_64-pc-windows-msvc.zip

tar xzf neton-v0.1.0-aarch64-apple-darwin.tar.gz
sudo mv neton /usr/local/bin/
neton --version

校验文件（.sha256）由 CI 自动附加。源码构建：cargo install --git https://github.com/yxpil/Neton。

---

Part of the BIT ecosystem · README · Wiki