NEEDLE is an open-source Rust-based agent orchestration harness and execution framework developed by Jed Arden. It provides structured execution loops, modular agent strands, and validation gates for running AI coding agents against codebases. At runtime, NEEDLE executes workflows through specialized sub-agents—such as WeaveAgent, ReflectAgent, and UnravelAgent—configured through a `.needle.yaml` specification. The orchestrator isolates test environments, dispatches tasks, and coordinates multi-step development actions while tracking execution lifecycle events. NEEDLE distinguishes itself from standard CLI chat wrappers by emphasizing strict quality gates and deep observability. It incorporates a unified definition-of-done system across pre-commit hooks, CI, and agent execution runs, complete with bypass tracking and OpenTelemetry (OTLP) resource reporting for host and process-level metrics. NEEDLE is published as an open-source project on GitHub under active development, written in Rust for minimal overhead in local and containerized CI environments.
Tags: agent harness, ai agent, cli, developer tools, OpenSource