punt-labs/beadle

README preview

# beadle

> A programmable agent daemon controlled by email, secured by GPG.

[![License](https://img.shields.io/github/license/punt-labs/beadle)](LICENSE)
[![CI](https://img.shields.io/github/actions/workflow/status/punt-labs/beadle/test.yml?label=CI)](https://github.com/punt-labs/beadle/actions/workflows/test.yml)
[![Go](https://img.shields.io/badge/Go-1.26+-00ADD8?logo=go&logoColor=white)](https://go.dev)
[![Go Report Card](https://goreportcard.com/badge/github.com/punt-labs/beadle)](https://goreportcard.com/report/github.com/punt-labs/beadle)
[![Working Backwards](https://img.shields.io/badge/Working_Backwards-hypothesis-lightgrey)](./prfaq.pdf)

Beadle is an autonomous agent that receives instructions via email and
executes them as multi-stage pipelines. Commands are programs, the
daemon is the shell, pipelines are pipes, and GPG signatures are sudo.
The owner controls what beadle can do by signing command definitions.
The trust gate controls who can trigger it.

**How it works.** You send an email. Beadle verifies your identity
(PGP signature or Proton E2E encryption), checks your permissions,
decomposes your instruction into a pipeline of commands, and executes
them — mixing AI reasoning with fast CLI tools. You get the result

View full repository on GitHub →