{"id":14046950,"url":"https://github.com/argoproj-labs/argocd-agent","last_synced_at":"2026-04-02T14:39:08.198Z","repository":{"id":223517932,"uuid":"706870108","full_name":"argoproj-labs/argocd-agent","owner":"argoproj-labs","description":"Redefining the multi cluster story of Argo CD","archived":false,"fork":false,"pushed_at":"2026-01-28T13:31:04.000Z","size":2955,"stargazers_count":418,"open_issues_count":33,"forks_count":56,"subscribers_count":11,"default_branch":"main","last_synced_at":"2026-01-29T02:33:21.754Z","etag":null,"topics":["agent-based","argo-cd","argocd","distributed","edge","gitops","multi-cluster","scaling","telco"],"latest_commit_sha":null,"homepage":"https://argocd-agent.readthedocs.io/latest/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/argoproj-labs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-10-18T19:21:55.000Z","updated_at":"2026-01-28T13:31:08.000Z","dependencies_parsed_at":"2024-08-09T15:57:36.222Z","dependency_job_id":"ec361a2a-b4cf-46dc-8860-f28109a1f259","html_url":"https://github.com/argoproj-labs/argocd-agent","commit_stats":null,"previous_names":["jannfis/argocd-agent","argoproj-labs/argocd-agent"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/argoproj-labs/argocd-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/argoproj-labs%2Fargocd-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/argoproj-labs%2Fargocd-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/argoproj-labs%2Fargocd-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/argoproj-labs%2Fargocd-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/argoproj-labs","download_url":"https://codeload.github.com/argoproj-labs/argocd-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/argoproj-labs%2Fargocd-agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29094675,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-04T19:16:55.479Z","status":"ssl_error","status_checked_at":"2026-02-04T19:16:52.508Z","response_time":62,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-based","argo-cd","argocd","distributed","edge","gitops","multi-cluster","scaling","telco"],"created_at":"2024-08-12T10:01:23.165Z","updated_at":"2026-02-04T20:04:49.963Z","avatar_url":"https://github.com/argoproj-labs.png","language":"Go","funding_links":[],"categories":["Ecosystem Projects","Go"],"sub_categories":[],"readme":"# argocd-agent ✨\n\n[![Integration tests](https://github.com/argoproj-labs/argocd-agent/actions/workflows/ci.yaml/badge.svg)](https://github.com/argoproj-labs/argocd-agent/actions/workflows/ci.yaml)\n[![Go Report Card](https://goreportcard.com/badge/github.com/argoproj-labs/argocd-agent)](https://goreportcard.com/report/github.com/argoproj-labs/argocd-agent)\n[![codecov](https://codecov.io/gh/argoproj-labs/argocd-agent/graph/badge.svg?token=NP5UEU279Z)](https://codecov.io/gh/argoproj-labs/argocd-agent)\n\n**Scale Argo CD across hundreds of clusters with a single pane of glass** 🌐\n\nImagine managing GitOps deployments across edge locations, multiple cloud providers, air-gapped environments, and remote sites—all from one central dashboard. argocd-agent makes this reality by extending Argo CD with a distributed architecture that brings the control plane to you, no matter where your workloads live.\n\n## 🚀 Why argocd-agent?\n\n**The Challenge**: Traditional multi-cluster Argo CD setups hit walls when scaling to hundreds of clusters, especially across unreliable networks, air-gapped environments, or edge locations.\n\n**The Solution**: argocd-agent flips the script—instead of your control plane reaching out to remote clusters, lightweight agents reach back to a central hub. This \"pull model\" enables:\n\n✅ **Massive Scale**: Manage thousands of applications across hundreds of clusters  \n✅ **Network Resilience**: Works with intermittent connections, high latency, or restricted networks  \n✅ **Edge-Friendly**: Perfect for IoT, retail, manufacturing, or remote deployments  \n✅ **Air-Gap Ready**: Secure deployments that never expose cluster internals  \n✅ **Cloud Agnostic**: Seamlessly span AWS, GCP, Azure, on-premises, and hybrid environments  \n\n## 🎯 Perfect For\n\n- **🏭 Manufacturing**: Deploy to factory floors and remote facilities\n- **🛒 Retail**: Manage point-of-sale and in-store systems across locations  \n- **🚢 Edge Computing**: IoT deployments, autonomous vehicles, ships, and remote sites\n- **🏛️ Enterprise**: Multi-datacenter deployments with strict security requirements\n- **☁️ Multi-Cloud**: Unified GitOps across different cloud providers\n- **🔒 Air-Gapped**: Secure environments with restricted network access\n\n## ⚡ Quick Start\n\nGet up and running in minutes! Check out our [**Getting Started Guide**](https://argocd-agent.readthedocs.io/latest/getting-started/) for step-by-step instructions.\n\n## 🏗️ How It Works\n\nThink of argocd-agent as a **hub-and-spoke architecture** where agents reach back to the control plane:\n\n```\n    ┌─────────────────┐\n    │  Control Plane  │  ← Your Argo CD UI and API\n    │   (The Hub)     │     (No outbound connections needed!)\n    └─────────────────┘\n              ▲ ▲ ▲\n              │ │ │\n              │ │ │\n┌─────────────┘ │ └─────────────┐\n│               │               │\n│               │               │\n┌─────────┐ ┌─────────┐ ┌─────────┐\n│ Agent 1 │ │ Agent 2 │ │ Agent N │  ← Each agent connects independently\n│ AWS     │ │ Factory │ │ Edge    │     (Pull model - no inter-agent links!)\n└─────────┘ └─────────┘ └─────────┘\n```\n\n**🎛️ Control Plane**: Your familiar Argo CD interface—manage everything from one place  \n**🤖 Agents**: Lightweight components that reach out and connect to the hub  \n**🔄 Smart Sync**: Agents pull configuration and push status updates automatically  \n\n### Two Flavors, One Experience\n\n**🎯 Managed Mode**: Perfect for centralized control  \n- Deploy applications from your control plane to remote clusters\n- Ideal for rolling out updates, managing configurations, and maintaining consistency\n\n**🦾 Autonomous Mode**: Built for independence  \n- Remote clusters manage their own applications (via GitOps)\n- Control plane provides observability and monitoring\n- Perfect for air-gapped or highly autonomous environments\n\nMix and match modes across your fleet - some clusters managed, others autonomous, all visible from one dashboard.\n\n## 🌟 Key Features\n\n### 🛡️ **Security First**\n- **mTLS everywhere**: All communications are encrypted and authenticated\n- **Zero trust**: Control plane never needs direct cluster access\n- **Certificate-based auth**: Strong identity verification for every agent\n\n### 🌐 **Network Resilient**\n- **Intermittent connections**: Agents work offline and sync when possible\n- **High latency tolerant**: Designed for satellite links, cellular, and unreliable networks\n- **HTTP/1.1 compatible**: Works through corporate proxies and legacy infrastructure\n\n### 📊 **Unified Observability**\n- **Single pane of glass**: See all clusters, applications, and deployments in one view\n- **Real-time status**: Health, sync status, and metrics from all environments\n- **Live resources**: Inspect Kubernetes resources across your entire fleet\n\n### ⚙️ **Operationally Friendly**\n- **Lightweight**: Minimal resource footprint on remote clusters\n- **Self-healing**: Agents automatically reconnect and recover\n- **Easy upgrades**: Rolling updates without downtime\n\n## 🚧 Current Status\n\nTrack our progress and vision in the [**milestones**](https://github.com/argoproj-labs/argocd-agent/milestones) on GitHub.\n\n## 🤝 Join the Community\n\nWe're building argocd-agent together! Whether you're a GitOps veteran or just getting started, there are many ways to contribute:\n\n**💬 Get Help \u0026 Share Ideas**\n- [GitHub Discussions](https://github.com/argoproj-labs/argocd-agent/discussions) - Ask questions, share use cases\n- [#argo-cd-agent](https://cloud-native.slack.com/archives/C07L5SX6A9J) on [CNCF Slack](https://slack.cncf.io/) - Real-time chat\n\n**🛠️ Contribute**\n- [Contributing Guide](https://argocd-agent.readthedocs.io/latest/contributing/) - Code, docs, and testing guidelines\n- [Issue Tracker](https://github.com/argoproj-labs/argocd-agent/issues) - Bug reports and feature requests\n- [Good First Issues](https://github.com/argoproj-labs/argocd-agent/labels/good%20first%20issue) - Perfect for newcomers\n\n**📖 Learn More**\n- [**Documentation**](https://argocd-agent.readthedocs.io/latest/) - Comprehensive guides and references\n- [**Architecture Deep Dive**](https://argocd-agent.readthedocs.io/latest/concepts/components-terminology/) - Understanding the internals\n- [**Configuration Guide**](https://argocd-agent.readthedocs.io/latest/configuration/) - Detailed setup instructions\n\n## 🏢 Ready to Deploy?\n\nargocd-agent is evolving into a **stable and reliable** project ready for adoption! The project has reached a state mature enough where users are encouraged to install and run it. We continue working toward GA, and we kindly ask for help from everyone to battle-test it.\n\n**Help us by:**\n\n- **🤝 Contributing to development** - Help us reach GA faster\n- **💡 Giving feedback** - Together, we can build a better product\n- **💼 Adoption** - Give it a spin, in any of your environments\n- **🗣️ Sharing your success stories** - We love hearing about your use cases\n\nReady to get started? [**Jump into our getting started guide**](https://argocd-agent.readthedocs.io/latest/getting-started/) or [**start a discussion**](https://github.com/argoproj-labs/argocd-agent/discussions) to share your plans!\n\n## 📜 License\n\nargocd-agent is licensed under the [Apache License 2.0](LICENSE).\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Built with ❤️ by the Argo community**\n\n[**⭐ Star us on GitHub**](https://github.com/argoproj-labs/argocd-agent) | [**📖 Read the Docs**](https://argocd-agent.readthedocs.io/latest/) | [**💬 Join the Discussion**](https://github.com/argoproj-labs/argocd-agent/discussions)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fargoproj-labs%2Fargocd-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fargoproj-labs%2Fargocd-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fargoproj-labs%2Fargocd-agent/lists"}