Skip to main content

CLI and TUI for orchestrating agent loops with Gemini CLI and Codex CLI.

Project description

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;

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agentsloop_cli-0.1.5.tar.gz (77.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agentsloop_cli-0.1.5-py3-none-any.whl (49.7 kB view details)

Uploaded Python 3

File details

Details for the file agentsloop_cli-0.1.5.tar.gz.

File metadata

  • Download URL: agentsloop_cli-0.1.5.tar.gz
  • Upload date:
  • Size: 77.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agentsloop_cli-0.1.5.tar.gz
Algorithm Hash digest
SHA256 bdf9df249066ea37b7b96dc18d49355871c29a564f588994184e76b6914a58e6
MD5 d3227e2c7dec3703d6cd0faf7e7afb7f
BLAKE2b-256 d5f1bfd88b217a9d1f5b6d887d22ab1cf07a618ead75b20b7c47ce9ca12e8276

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentsloop_cli-0.1.5.tar.gz:

Publisher: release.yml on Thomas97460/AgentsLoop-CLI

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file agentsloop_cli-0.1.5-py3-none-any.whl.

File metadata

  • Download URL: agentsloop_cli-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 49.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agentsloop_cli-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 c7c2858c3fe92afe2d9c8ccf3ba9cde435a452d0712d7b8efea74e1a0b5934a5
MD5 6cf6f490443959a50324d3f0b5a9a039
BLAKE2b-256 7262f308dacab7e1464d52c570ee569f2b7f30fb57a7add2cfc6a8337485d1ad

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentsloop_cli-0.1.5-py3-none-any.whl:

Publisher: release.yml on Thomas97460/AgentsLoop-CLI

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page