An Argo CD UI extension that adds an Assistant tab to the resource view. Open any Kubernetes resource, ask questions about it in natural language, and the extension enriches each query with context:
Resource manifest- the live object, provided by Argo CD.** Events**- fetched from the Argo CD API and attached automatically.** Logs**(optional) - from a single container, via a guided flow (Pod, Deployment, StatefulSet, Job, Rollout).
A single generic provider speaks the OpenAI-compatible chat completions API, so it works with any backend that does: a local inference server (e.g. Ollama), vLLM, OpenAI, Azure OpenAI, or any other OpenAI-compatible endpoint. Traffic is routed through the Argo CD Proxy Extension to avoid CORS.
Argo CD>= v2.13- A running LLM backend with an OpenAI-compatible API accessible from the Argo CD server
yarn install --force
yarn run build
yarn run build-dev
Releases are automated: on merge to main
(once CI passes), a workflow classifies the change, bumps the version, tags it, and publishes a GitHub Release with the extension tar. No manual version bumping. See Build and Package for details.
See the Deployment Guide for step-by-step instructions on building, packaging, hosting, and installing the extension into Argo CD via the Extension Installer. It covers the Argo CD Operator, the community Helm chart, and raw manifests.
To try the extension end to end on a throwaway kind cluster - with a built-in mock LLM, no GPU or API key required - use the harness in examples/kind/:
./examples/kind/setup.sh raw # or: helm | operator
A successful run installs Argo CD, installs this extension built from source, and verifies the full path (including a streamed proxy request) with == 8 passed, 0 failed ==
. See examples/kind/README.md.
Full documentation is in the docs/ directory and built with
Live docs: argocd-ai-assistant.readthedocs.io
Source and releases: github.com/saidsef/argocd-ai-assistant.
Pull requests welcome - see the Contribution Guide.