ai
Groq CLI for Headless Automation
Use the Groq CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 5 read 2 write API key auth
Groq 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 Groq CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Groq CLI for Headless Automation
kosmokrator integrations:configure groq --set api_key="$GROQ_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call groq.groq_list_models '{}' --json Discovery Before Execution
Agents and scripts can inspect Groq docs and schemas before choosing a function.
kosmo integrations:docs groq --json
kosmo integrations:docs groq.groq_list_models --json
kosmo integrations:schema groq.groq_list_models --json
kosmo integrations:search "Groq" --json
kosmo integrations:list --json Useful Groq CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
groq.groq_list_models | Read | none | List available Groq AI models. Returns model IDs, ownership, and other metadata for models accessible via the Groq API. |
groq.groq_create_completion | Write | model, messages, temperature, max_tokens, top_p, stream | Create a chat completion using a Groq model. Send a list of messages and receive an AI-generated response with ultra-low latency. Supports configurable parameters like temperature, max_tokens, and top_p. |
groq.groq_list_messages | Read | conversation_id, limit, after | List messages in a Groq Cloud conversation. Returns message content, role, and metadata for each message in the conversation. |
groq.groq_create_message | Write | conversation_id, role, content | Create a message in a Groq Cloud conversation. Send a message with a specified role and content to a conversation. |
groq.groq_list_files | Read | purpose, limit, after | List files uploaded to the Groq Files API. Returns file IDs, filenames, purposes, sizes, and upload timestamps. |
groq.groq_get_file | Read | file_id | Get metadata for an uploaded file in Groq, including its ID, filename, purpose, size in bytes, and processing status. |
groq.groq_get_current_user | Read | none | Get information about the currently authenticated Groq user, including user ID, email, and organization details. |
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.