Originally published on gkosmo.eu.

An agent is a background job that gets to call a few methods

I have been putting this post off for months. Partly because "AI agents" is a phrase that makes me tired, and partly because most of what I read about it is either a demo that writes haikus or an architecture diagram with eleven boxes.

Here is what I actually run. It's small. You can paste it into a Rails app this afternoon.

The gems are rcrewai and rcrewai-rails. I maintain both and I use them on nakyma.io, so this is not a neutral review. It is the thing I reach for.