Auto_Claude_CLI 🤖👐

The Zero-Intervention Software Factory

从想法到交付，只需一个脚本。体验真正的“解放双手”。

Liberate your hands. Experience true hands-free software development. Auto_Claude_CLI is a headless software factory powered by a single script. It orchestrates a virtual team of AI agents (PM, Architect, Developer, QA) to transform raw ideas into fully functional, refactored, and tested codebases while you sleep.

---

💸 Cost-Efficiency & SupportMe

Run full autonomous cycles for < $0.10 / day.

Don't overpay for coding. I highly recommend using the GLM-Coding model with Claude CLI for the best cost-to-performance ratio.

👉 Try GLM-Coding (High Performance, Low Cost)

Signing up via this link reduces your API costs and directly supports my open-source work!

---

⚡ Quick Start

Get up and running Now. No complex environment setup required.

# Windows
curl https://raw.githubusercontent.com/vincentzzh424/auto_claude_cli/main/run.py -o run.py; python run.py "write a test print hello world"
# Mac&Linux
curl -sL https://raw.githubusercontent.com/vincentzzh424/auto_claude_cli/main/run.py | python - "write a test print hello world"

1. Prerequisite: Claude CLI

Install the underlying driver (Node.js required).

npm install -g @anthropic-ai/claude-code

Option A (Recommended): Get GLM-Coding Key (~$0.1/day)

Option B: Use Official Anthropic Key ($20/month)

2. Init Auto_Claude_CLI

Dependency-free , minimal python requirements.

git clone https://github.com/vincentzzh424/auto_claude_cli.git
cd auto_claude_cli
# (Optional) Create a workspace to keep things clean
mkdir demo && cd demo

3. Make Your Idea Come True

# Run the script from the parent directory (or add to path) with your idea.
python ../run.py "Create a Personal Website with a dark mode toggle"

💡4. Simple Utility

python ../run.py "Create a CLI tool to resize and watermark images in a folder"

💡Complex System Tip: Use ChatGPT/Gemini to refine your prompt into a detailed specification before pasting it here.

python ../run.py "Build a Bloomberg-like terminal for crypto trading. Features: WebSocket data feed for BTC/ETH, real-time K-line visualization using mplfinance, and MACD/RSI indicator calculation. No mock data."

Shopping System Example

🔄 Resume & Progress (New)

Projects can run for days. Auto_Claude_CLI now supports checkpoint resume — pick up exactly where you left off.

# Default mode: resume from last checkpoint (reads PROGRESS.md)
python ../run.py

# Force start from scratch (ignore existing progress)
python ../run.py "your idea" --force

# Custom rate-limit retry interval (default: 600s = 10 min)
python ../run.py "your idea" --retry-wait 300

How it works:

• A PROGRESS.md file is auto-generated in your workspace, tracking every pipeline stage and module sub-step
• On re-run, all completed stages are skipped — resumes from the first pending step
• API health check before each Claude call: detects rate limits (429) and auto-waits with countdown
• You can manually edit PROGRESS.md to skip or retry any stage (change [x] to [ ])

---

⚠️ Safety Warning

Please Read Before Use

To achieve true "hands-free" autonomy, this tool executes the Claude CLI with the --dangerously-skip-permissions flag enabled.

Risk: The agent has full filesystem access (read/write/delete).

Recommendation: Always run this tool inside a Sandbox, Docker container, or a dedicated empty directory to prevent accidental data loss.

🤝 Contributing

We believe in the power of autonomous agents. Pull Requests to improve the driver logic or prompt engineering are welcome.

📄 License MIT © [vincentzzh424]