> ## Documentation Index
> Fetch the complete documentation index at: https://diasporic3lee7-timerloggedout-ter-69-67-120-secure-and-opti.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# AGENTIC CICD FREE TIER

# Agentic CI/CD — Free-tier stack (termux-monorepo)

This document describes the free-tier-only autonomous / agentic development CI/CD integrations.

## Active free-tier components

| Component | Role | Status | Free tier notes |
| - | - | - | - |
| **Jules** (Google Labs) | Async autonomous coding agent (fix bugs, features, tests) | Integrated (`.Jules/`, `agent-review-auto-jules.yml`, `agent-jules-on-issues.yml`) | Introductory daily task limits |
| **CodeRabbit** | AI PR review + autofix | Integrated (`.coderabbit.yaml`) | Free summaries + limited reviews; full free for public/OSS |
| **Gemini CLI GitHub Action** | Issue triage, PR review, `@gemini-cli` on-demand teammate | Integrated | Google AI Studio free quota |
| **GitHub MCP Server** | Tool access for agents (issues/PRs/code) | Usable via Gemini settings | Fully free / OSS |
| Render (Marketplace) | Deploy / self-healing hooks (noted in README) | Already installed per README | Free tier exists |

## How the loop works

1. Issue opened → Gemini triage (labels, priority, duplicate check).
2. PR opened → CodeRabbit review + Gemini review comment.
3. Bot feedback (CodeRabbit/Devin/…) → existing `agent-review-auto-jules.yml` posts `@jules` and optionally invokes Jules API.
4. Human or bot comments `@gemini-cli <request>` → Gemini on-demand invoke (👀 ack).
5. Human comments `@jules <task>` or labels `jules` → Jules on-issues workflow + App path.
6. Jules works asynchronously in a Cloud VM and opens/updates PRs for review.
7. **Coordination**: both Jules and Gemini prompts receive an inventory of open agent PRs and must avoid overlapping files; they post `<!-- agent-claim -->` markers when claiming work.

All pieces above have a free tier. Paid upgrades (Google AI Pro/Ultra for higher Jules limits, CodeRabbit Pro, etc.) are optional.

## Required secrets / variables (user action)

* `GEMINI_API_KEY` — Google AI Studio free key (required for Gemini workflows)
* `JULES_API_KEY` — optional; enables structured `jules-invoke` (App + `@jules` comment still work without it)
* Workflow permissions: Read and write for GITHUB\_TOKEN (Settings → Actions → General)

## Activation note

GitHub only runs `issues` / `issue_comment` workflows from the **default branch** (`master`). The agentic workflow files must exist there for `@jules` / `@gemini-cli` mentions to respond.

## Security notes

* Gemini workflows restrict `@gemini-cli` comment triggers to OWNER/MEMBER/COLLABORATOR.
* Jules mention triggers similarly restricted.
* Fork PRs are excluded from automatic review triggers.
* GEMINI.md encodes the same hard rules as AGENTS.md (no secrets in git, master-staging, gates) plus coordination rules.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.