Autonomous Agents Template

Autonomous Agents Template

A template repository for creating autonomous AI agents using Claude. This template provides scripts and structure for task-based autonomous agent workflows.

Features

• 🤖 Autonomous task execution with Claude or Gemini
• 📋 Issue and plan management system with todo tracking
• 🎨 Beautiful formatted output with progress tracking
• 🔄 Single task or continuous execution modes
• 📝 Structured issue and plan templates

Prerequisites

• Claude CLI or Gemini CLI installed and configured
• Bash shell (macOS/Linux)
• jq for JSON parsing (install with brew install jq or apt-get install jq)

Available Commands

This template provides npm scripts for all operations:

# Claude commands
npm run agent               # Run Claude agent for one task
npm run agent:auto          # Run Claude agent continuously for all tasks

# Gemini commands
npm run agent:gemini        # Run Gemini agent for one task
npm run agent:gemini:auto   # Run Gemini agent continuously for all tasks

# Other commands
npm run issue         # Create a new issue
npm run bootstrap     # Create a bootstrap issue from master plan
npm run complete      # Manually mark an issue as complete
npm run test          # Run all tests
npm run test:unit     # Run unit tests only

Quick Start

1. **Clone this template**

   git clone 
   cd autonomous-agents-template

2. **Create your first issue**

   npm run issue "Build a REST API for user management"

3. **Run the agent**

   # Run a single task with Claude
   npm run agent
   
   # Run all tasks continuously with Gemini
   npm run agent:gemini:auto

Bootstrapping from a Master Plan

When you have a comprehensive plan or specification document, you can bootstrap your entire project structure:

1. **Create Master Plan**

First, create a detailed plan document:

echo "Your