Skip to content

Thomas97460/AgentsLoop-CLI

AgentsLoop CLI Demo

Watch AgentsLoop CLI in action

CI Ruff Testing Python Version

Autonomous orchestration for software engineering workflows.

AgentsLoop CLI is an orchestrator for autonomous agent loops. It coordinates a three-node loop (CTO, Developer, and Validation) to automate software engineering tasks.

🔄 The Loop: How it Works

graph LR
    CTO["<b>CTO</b><br/>CLI Agent"]
    DEV["<b>Developer</b><br/>CLI Agent"]
    VAL["<b>Validation</b><br/>bash command"]

    CTO --> DEV
    DEV --> VAL
    VAL -.->|Feedback| CTO

    classDef agents fill:#e1f5fe,stroke:#01579b,stroke-width:2px,color:#01579b;
    classDef validation fill:#f9f9f9,stroke:#333,stroke-width:1px,color:#333;
    
    class CTO,DEV agents;
    class VAL validation;
Loading

Key Features

  • Autonomous Loop: CTO plans, Developer implements, and Validation tests.
  • Multi-Provider Support: Seamlessly switch between Gemini, Codex, and Copilot.
  • No API Key Required: Works with your existing provider subscriptions via their respective CLIs.
  • TUI Interface: Terminal user interface to monitor workflows in real-time.
  • Git Integration: Works directly within your repositories, creating isolated branches for safety.
  • Coming Soon: Support for Claude Code.

Installation

With pip

pip install agentsloop-cli

With uv

Install as a global tool:

uv tool install agentsloop-cli

Directly from source

curl -fsSL https://raw.githubusercontent.com/Thomas97460/AgentsLoop-CLI/main/install.sh | bash

Prerequisites

  • Python 3.12 or newer.
  • At least one of gemini, codex, or copilot CLI installed and authenticated.

Usage

cd ~/your_git_repository/ && agentsloop

Contributing

We welcome contributions! Please check CONTRIBUTING.md and AGENTS.md for development guidelines.

uv sync --dev
uv run pytest

About

Autonomous CLI orchestrator for software engineering agent loops with CTO, Developer, and Validation roles.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors