tiny-bots

Open source, for macOS and Linux

Agents that wake when something happens.

Not a cron job that fires into an empty inbox every five minutes. tiny-bots sleeps until a file changes, a webhook lands, or a feed moves, then wakes the agent that cares. One static binary for macOS and Linux, with nothing else to install.

Six ways a bot wakes up

A trigger is the whole point. A bot costs nothing while it waits, so you can leave many of them switched on.

A file changed

Watched with inotify on Linux and kqueue on macOS, debounced, never polled.

A webhook arrived

A public endpoint through Tailscale Funnel, with no port opened on the box.

A feed moved

Polled on its own interval, with what was already seen remembered across restarts.

A stream said something

A long-lived connection that reconnects by itself and picks up where it stopped.

A time came

Still there when a schedule is genuinely what you want, with drift measured.

You asked

From the app, the phone, or the terminal, with the transcript recorded either way.

Measured, not estimated

Every number here comes from a run on real hardware, against a budget set before the code was written. The build fails if one regresses.

1.8 msEvent to wake, p95, against a 250 ms budget
30 MBThe whole binary, against a 40 MB budget
33 MBResident while idle, against 75 MB
0Runtimes, daemons or containers to install first

Start in about a minute

On macOS or Linux, amd64 or arm64.

curl -fsSL https://aicrew.in/install.sh | sh
tb init
tb serve