v0.1.0 — initial public release

v0.1.0 — initial public release

Framework-agnostic Java observability sidecar agent. Attach to a running JVM (Arthas-style) and chat with it via MCP / web UI / curl to understand live state: request metrics, slow calls, errors, logs, thread dumps, and method-level traces.

Highlights

• In-JVM ring buffers (metrics / slow calls / errors / logs) — zero external storage
• MCP server (JSON-RPC over HTTP) + built-in chat web UI (OpenAI-compatible LLM, BYO key)
• On-demand method diagnostics: watch_method (captures) + trace_request (call tree)
• Framework-agnostic (Servlet); ByteBuddy; shaded jar (no host classpath pollution)
• Security: loopback bind by default, token auth (constant-time compare), scrubber for tokens/PII, instrumentation behind a gate, 2 MB request-body cap

Install

Download obs-agent-core-0.1.0-all.jar below, or build from source (JDK 21+):

./gradlew :obs-agent-core:shadowJar

Attach to a running JVM

java --add-modules jdk.attach -cp scripts Attach <pid> obs-agent-core-0.1.0-all.jar "port=9911,token=<strong-token>,enableInstrumentation=true"

See the README for full usage / config / tools. 中文文档：README.zh-CN.md.

Requires JDK 17+ target JVM; JDK 21+ to build. Apache-2.0.