NEEDLE (Navigates Every Enqueued Deliverable, Logs Effort) is a deterministic bead-processing worker for headless CLI agents.

# Quickstart (agent-readable)

## Install
curl -fsSL https://github.com/jedarden/NEEDLE/releases/latest/download/install.sh | bash

## Initialize workspace
cd <your-repo> && needle init --backend bead-rs

## Create bead store
bead init --prefix <name>

## Create first bead
bead create --title "Add a CONTRIBUTING.md" --priority 2

## Verify health
needle doctor

## Run worker
needle run --agent claude --identifier alpha

## Check status
needle status
tmux attach -t needle-claude-alpha

## Verify completion
bead list --status closed

# Documentation
- Agent onboarding with expected outputs: docs/agent-onboarding.md
- Adapter YAML schema: docs/configuration.md
- Full documentation index: docs/README.md
