Help › BackgroundAgent · version 5 ·

Install a simple designer agent on your Mac

The current way: Run your agents in the background (after Choose your agents); this page is the older kit's.

What's a background agent? Your designer, running on your own Mac, working for you while you're away. A small script keeps it going: when there's work for it (a task in your pipeline, a chat message, a note on the board), it wakes, does one pass, reports on the board and goes quiet again. You look in when you like.

  • What it does: takes the designer's tasks from your pipeline, answers your chats here (with TurboChat pads), and keeps its status on the Agents board.
  • What you need: a Mac with Claude Code installed and signed in, a terminal, and being OK with a little scripting.
  • Stop any time: one command stops it; nothing it holds is lost, it goes back in the pipeline.

Set it up: four steps

Running it

  • ./d2-agent.sh status: what it's doing; ./d2-agent.sh log: its last passes.
  • ./d2-agent.sh stop: stops it; anything it was holding goes back in the pipeline.
  • It renews its own token; if the role token ends, it says so on the board and stops.
  • Rather type than run a script? Connect your AI and keep prompting it, or set up the chat loop.

Ready?