Project

agent-loop

0.0
The project is in a healthy, maintained state
Run Claude Code CLI in a loop, working tasks one by one from a Prompt.md
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Runtime

~> 1.2
 Project Readme

Agent Loop

A command line utility that runs the Pi coding agent in a loop to work tasks one by one from a Prompt.md

Project Goals

  1. Can be cloned down and run with minimal setup
  2. This project can work in existing repos with minimal configuration
  3. Zero dependencies other than Pi and bash

Install

bash <(curl -fsSL https://raw.githubusercontent.com/BrandonMathis/agent-loop/main/install.sh)

This always downloads the latest start_agent_loop.sh into your current directory. It downloads Prompt.md only when one does not already exist.

Before running the loop, install and authenticate the pi CLI.

Usage

  1. Edit Prompt.md with your tasks
  2. Run agent loop script

Default

./start_agent_loop.sh

Trust Project Pi Resources

./start_agent_loop.sh --dangerous

By default the script runs pi -p --no-approve, so project-local Pi settings and extensions are not approved for the non-interactive run. The --dangerous flag changes this to pi -p --approve, allowing Pi to trust and load project-local resources. Only use it in repositories you trust.