CLI and TUI for orchestrating agent loops with Gemini CLI and Codex CLI.
Project description
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, orcopilotCLI 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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agentsloop_cli-0.1.4.tar.gz.
File metadata
- Download URL: agentsloop_cli-0.1.4.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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d0b9de945b3f5633d08f1f2daa3aef3d074fcd38b4ba6b1a8d7e52584736f680
|
|
| MD5 |
0b9b33ccdaab29998ad6a925fbd2d219
|
|
| BLAKE2b-256 |
663ef2ecad7b7bdfd5dd75181210c7358722f63d5e451d32999a3b44652d4497
|
Provenance
The following attestation bundles were made for agentsloop_cli-0.1.4.tar.gz:
Publisher:
release.yml on Thomas97460/AgentsLoop-CLI
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
agentsloop_cli-0.1.4.tar.gz -
Subject digest:
d0b9de945b3f5633d08f1f2daa3aef3d074fcd38b4ba6b1a8d7e52584736f680 - Sigstore transparency entry: 1437150791
- Sigstore integration time:
-
Permalink:
Thomas97460/AgentsLoop-CLI@71ef80a911547e1b48fda6d9502334fb0972f05a -
Branch / Tag:
refs/tags/v0.1.4 - Owner: https://github.com/Thomas97460
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@71ef80a911547e1b48fda6d9502334fb0972f05a -
Trigger Event:
push
-
Statement type:
File details
Details for the file agentsloop_cli-0.1.4-py3-none-any.whl.
File metadata
- Download URL: agentsloop_cli-0.1.4-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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
03e3873b1800b2798a49e077094a77165c776032efa9316b4d3dcf2d73f90e55
|
|
| MD5 |
fd9d16268bf8c90f949399f22da7d249
|
|
| BLAKE2b-256 |
46ee12f1cbb0b08cdd1d2f73d3016287c6e4cd73141e4ac4db000695b87190de
|
Provenance
The following attestation bundles were made for agentsloop_cli-0.1.4-py3-none-any.whl:
Publisher:
release.yml on Thomas97460/AgentsLoop-CLI
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
agentsloop_cli-0.1.4-py3-none-any.whl -
Subject digest:
03e3873b1800b2798a49e077094a77165c776032efa9316b4d3dcf2d73f90e55 - Sigstore transparency entry: 1437150802
- Sigstore integration time:
-
Permalink:
Thomas97460/AgentsLoop-CLI@71ef80a911547e1b48fda6d9502334fb0972f05a -
Branch / Tag:
refs/tags/v0.1.4 - Owner: https://github.com/Thomas97460
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@71ef80a911547e1b48fda6d9502334fb0972f05a -
Trigger Event:
push
-
Statement type: