productivity
Argo CD CLI for Headless Automation
Use the Argo CD CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 6 read 1 write API key auth
Argo CD CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The Argo CD CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Argo CD CLI for Headless Automation
kosmokrator integrations:configure argocd --set api_key="$ARGOCD_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call argocd.argocd_list_applications '{"project":"example_project","selector":"example_selector","repo":"example_repo"}' --json Discovery Before Execution
Agents and scripts can inspect Argo CD docs and schemas before choosing a function.
kosmo integrations:docs argocd --json
kosmo integrations:docs argocd.argocd_list_applications --json
kosmo integrations:schema argocd.argocd_list_applications --json
kosmo integrations:search "Argo CD" --json
kosmo integrations:list --json Useful Argo CD CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
argocd.argocd_list_applications | Read | project, selector, repo | List all Argo CD applications. Optionally filter by project or label selector. |
argocd.argocd_get_application | Read | name, project, refresh | Get details for a specific Argo CD application, including sync status, health, source, and destination. |
argocd.argocd_create_application | Write | name, project, repo_url, path, revision, dest_server, dest_namespace, sync_policy, sync_options, labels, description | Create a new Argo CD application. Requires application name, project, source repository with path and revision, and destination cluster/namespace. |
argocd.argocd_list_projects | Read | none | List all Argo CD projects. |
argocd.argocd_get_project | Read | name | Get details for a specific Argo CD project, including source/destination rules and cluster configurations. |
argocd.argocd_list_repositories | Read | repo | List all configured Git repositories in Argo CD, including connection status. |
argocd.argocd_get_current_user | Read | none | Get the authenticated Argo CD user's profile information. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.