productivity
Heroku CLI for Headless Automation
Use the Heroku CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 7 read 0 write API key auth
Heroku 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 Heroku CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Heroku CLI for Headless Automation
kosmokrator integrations:configure heroku --set api_key="$HEROKU_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call heroku.heroku_list_apps '{}' --json Discovery Before Execution
Agents and scripts can inspect Heroku docs and schemas before choosing a function.
kosmo integrations:docs heroku --json
kosmo integrations:docs heroku.heroku_list_apps --json
kosmo integrations:schema heroku.heroku_list_apps --json
kosmo integrations:search "Heroku" --json
kosmo integrations:list --json Useful Heroku CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
heroku.heroku_list_apps | Read | none | List all Heroku apps the authenticated user has access to. Returns app names, IDs, regions, and status. |
heroku.heroku_get_app | Read | app_id | Get details for a specific Heroku app by ID or name. Returns full app information including region, stack, and Git URL. |
heroku.heroku_list_dynos | Read | app_id | List all dynos for a given Heroku app. Returns dyno names, types, sizes, states, and uptime. |
heroku.heroku_list_addons | Read | app_id | List all add-ons attached to a given Heroku app. Returns add-on names, plans, states, and provider details. |
heroku.heroku_list_domains | Read | app_id | List all domains for a given Heroku app. Returns domain hostnames, types (custom/Heroku), and status. |
heroku.heroku_list_collaborators | Read | app_id | List all collaborators for a given Heroku app. Returns collaborator emails, roles, and permissions. |
heroku.heroku_get_current_user | Read | none | Get information about the current authenticated Heroku account, including email, name, and verified status. |
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.