[Canonical HTML page](https://githits.com/software-factories/needle/)

1. [Software Factory Directory](/software-factories.md)
2. [Agent orchestration](/software-factories/category/agent-orchestration.md)
3. NEEDLE

# NEEDLE

[Agent orchestration](/software-factories/category/agent-orchestration.md) Open source

[Visit website ](https://jedarden.com/projects/needle/)[View on GitHub](https://github.com/jedarden/NEEDLE)

Headless agent orchestrator that processes a task queue through a deterministic state machine.

## Overview

NEEDLE is a headless orchestrator for coding agents. It works through a task queue, moving each task through a deterministic state machine so that agent runs follow a predictable sequence.

NEEDLE is written in Rust and fully open source under the MIT license. Its source of record is a Forgejo instance mirrored to GitHub. There is no hosted version and no paid offering.

## Features

* Runs headless, without a user interface.
* Processes work from a task queue.
* Uses a deterministic state machine.
* Written in Rust and open source under MIT.

## Details

* Website

  [jedarden.com/projects/needle](https://jedarden.com/projects/needle/)

* Company

  NEEDLE (jedarden)

* Category

  [Agent orchestration](/software-factories/category/agent-orchestration.md)

* Source

  Open source

* Repository

  * [github.com/jedarden/NEEDLE](https://github.com/jedarden/NEEDLE) · 28 stars

* License

  MIT

* Commercial offering

  None found

* Topics

  * [Background agents](/software-factories/?tag=background-agents)

* Listed

  October 2026

* Last verified

  October 2026

## Similar software factories

* ### [Aeon](/software-factories/aeon.md)
  [Open sourceOpen-source framework that runs unattended on GitHub Actions, dispatching markdown-defined skills and repairing failing ones.Agent orchestration GitHub stars: 777](/software-factories/aeon.md)
* ### [Alfred](/software-factories/alfred.md)
  [Open sourceLocal, scheduled agent fleet driven by GitHub issue labels and built on Claude Code, Codex and OpenCode.Agent orchestration GitHub stars: 4](/software-factories/alfred.md)
* ### [Cyrus](/software-factories/cyrus.md)
  [Open sourceClaude Code background agent for Linear, Slack, GitHub and GitLab that can be self-hosted or used as a cloud service.Agent orchestration GitHub stars: 857](/software-factories/cyrus.md)
* ### [engrams](/software-factories/engrams.md)
  [Open sourceOpen-source, self-hosted software factory that runs Claude Code, Codex or your own harness in Firecracker microVMs in your cloud.Agent orchestration GitHub stars: 54](/software-factories/engrams.md)

[All agent orchestration](/software-factories/category/agent-orchestration.md)