// readme

npm install -g @pmndrs/pine

PINE makes AI reactive

Most harnesses just do input chat: “Do this do that”. And maybe a scheduler: “Do it tomorrow”. In PINE agents react to any stimuli. From watching folders, commands, websites, ftp endpoints, webhooks, to any other event source. You can hook them up and let them react to and operate your physical devices in the house, or digital assets.

PINE of course also handles regular chat, coding, tasks and orchestration. Agents carry memory and so on. All the basic stuff is in there, too.

Some design choices

  • Event-driven architecture: Agents subscribe to events and react. An event source is just a *.ts service with a schema. Tell the agent what you want and they subscribe: “Watch ~/documents/scans, for every new file: extract summaries and payment details, if present”
  • No configs: Tell the main agent what you want. It configures PINE, creates agents, MCPs, event sources, skills and schedules through administrative tool calls, never touches user config, never messes it up or breaks it.
  • Self-discovery: A built-in BM25 manual tool lets agents look up any API or internal detail on demand, without…