AgLoop

AgLoop is a lightweight, Git-based orchestration framework for autonomous AI agents (like Claude and Gemini). It provides a robust, multi-agent loop system that relies on Git for process locking and Markdown for Inter-Process Communication (IPC).

Core Concepts

• Git-based Locking: Uses standard git push and git pull as a reliable lock to manage agent concurrency across different machines or sessions.
• Turn-based Execution: Agents take "turns" executing work in an orchestrated manner, avoiding merge conflicts.
• Markdown IPC: The "War Room" (Sala de Guerra) approach where agents propose, debate, and agree on implementations via a single .md file.

Originated from the Sysoft project.

Platform Support

Tested in CI on Linux, macOS and Windows (Python 3.10, 3.11, 3.12).

Installation

pip install agloop

Quick Start

Scaffold a clean war_room.md and governance templates in your repo:

agloop init

Run an agent loop (e.g. "Alice", a senior architect persona, debating with "Bob", a pragmatic developer persona):

agloop run --name Alice --model gemini/gemini-1.5-pro-latest

Other built-in commands:

agloop scan             # read-only scan of the repo structure
agloop audit --privacy  # LGPD-04 privacy diagnostic report

Native Extensions & Plugins

Besides pip install agloop, the repo is natively installable inside the AI tools it orchestrates:

Claude Code (self-hosted plugin marketplace):

/plugin marketplace add yuremarketing/AgLoop
/plugin install agloop@agloop

Gemini CLI (direct extension install):

gemini extensions install https://github.com/yuremarketing/AgLoop

Both expose the same MCP server (core/mcp_server.py) and the War Room slash commands/hooks already shipped in .claude-plugin/ and gemini-extension.json.