Product
Introducing GitHub Actions Scanning Support
Detect malware, unsafe data flows, and license issues in GitHub Actions with Socket’s new workflow scanning support.
By Rakesh Chatrath, Greg Tystahl -  Oct 23, 2025
🚀 DAY 4 OF LAUNCH WEEK: Introducing GitHub Actions Scanning Support.Learn more →
@heroku/plugin-ai
Advanced tools
@heroku-cli/plugin-ai
Heroku AI CLI plugin
Usage
$ heroku plugins:install @heroku-cli/plugin-ai
$ heroku ai:COMMAND
running command...
$ heroku ai --help [COMMAND]
USAGE
$ heroku ai:COMMAND
...
Commands
heroku ai:agents:call [MODEL_RESOURCE]heroku ai:docsheroku ai:mcp [ADDON]heroku ai:modelsheroku ai:models:attach MODEL_RESOURCEheroku ai:models:call MODEL_RESOURCEheroku ai:models:create MODEL_NAMEheroku ai:models:destroy MODEL_RESOURCEheroku ai:models:detach MODEL_RESOURCEheroku ai:models:info [MODEL_RESOURCE]heroku ai:models:listheroku ai:tools:list [ADDON]
heroku ai:agents:call [MODEL_RESOURCE]
make an inference request to the Heroku Inference Agents API
USAGE
$ heroku ai:agents:call [MODEL_RESOURCE] [-a <value>] [-j | -o <value>] [--optfile <value> | --opts <value>] [-p
<value> | --messages <value>] [-r <value>]
ARGUMENTS
MODEL_RESOURCE [default: heroku-inference] resource ID or alias of model (--app flag required if alias is used)
FLAGS
-a, --app=<value> name or ID of app (required if alias is used)
-j, --json output response as JSON
-o, --output=<value> file path where command writes the model response
-p, --prompt=<value> input prompt for model (will be converted to a user message)
-r, --remote=<value> git remote of app to use
--messages=<value> JSON array of messages to send to the model
--optfile=<value> additional options for model inference, provided as a JSON config file
--opts=<value> additional options for model inference, provided as a JSON string
DESCRIPTION
make an inference request to the Heroku Inference Agents API
EXAMPLES
$ heroku ai:agents:call my_llm --app my-app --prompt "What is the current time?"
$ heroku ai:agents:call my_llm --app my-app --messages '[{"role":"user","content":"What is the current time?"}]'
See code: src/commands/ai/agents/call.ts
heroku ai:docs
open Heroku Managed Inference and Agent's Dev Center documentation in your browser
USAGE
$ heroku ai:docs [--browser <value>]
FLAGS
--browser=<value> browser to open docs with (example: "firefox", "safari")
DESCRIPTION
open Heroku Managed Inference and Agent's Dev Center documentation in your browser
See code: src/commands/ai/docs.ts
heroku ai:mcp [ADDON]
list the MCP server URL
USAGE
$ heroku ai:mcp [ADDON] [--json] [-a <value>]
ARGUMENTS
ADDON [default: heroku-inference] unique identifier or globally unique name of add-on
FLAGS
-a, --app=<value> app to list the MCP server URL for
--json output in JSON format
DESCRIPTION
list the MCP server URL
See code: src/commands/ai/mcp/index.ts
heroku ai:models
list available AI models to provision access to
USAGE
$ heroku ai:models
DESCRIPTION
list available AI models to provision access to
ALIASES
$ heroku ai:models
EXAMPLES
$ heroku ai:models:list
heroku ai:models:attach MODEL_RESOURCE
attach an existing model resource to an app
USAGE
$ heroku ai:models:attach MODEL_RESOURCE -s <value> -t <value> [--as <value>] [--confirm <value>] [-r <value>]
ARGUMENTS
MODEL_RESOURCE resource ID or alias of model resource to attach
FLAGS
-r, --remote=<value> git remote of target app
-s, --source-app=<value> (required) source app for model resource
-t, --target-app=<value> (required) target app for model resource
--as=<value> alias name for model resource
--confirm=<value> overwrite existing attached resource with same name
DESCRIPTION
attach an existing model resource to an app
EXAMPLES
$ heroku ai:models:attach claude-3-5-sonnet-acute-41518 --source-app example-source-app --target-app example-target-app
$ heroku ai:models:attach claude-3-5-sonnet-acute-41518 --source-app example-source-app --target-app example-target-app --as MY_CS35
See code: src/commands/ai/models/attach.ts
heroku ai:models:call MODEL_RESOURCE
make an inference request to a specific AI model resource
USAGE
$ heroku ai:models:call MODEL_RESOURCE [-a <value>] [-j] [--optfile <value>] [--opts <value>] [-o <value>] [-p
<value>] [-r <value>]
ARGUMENTS
MODEL_RESOURCE resource ID or alias of model (--app flag required if alias is used)
FLAGS
-a, --app=<value> name or ID of app (required if alias is used)
-j, --json output response as JSON
-o, --output=<value> file path where command writes the model response
-p, --prompt=<value> input prompt for model
-r, --remote=<value> git remote of app to use
--optfile=<value> additional options for model inference, provided as a JSON config file
--opts=<value> additional options for model inference, provided as a JSON string
DESCRIPTION
make an inference request to a specific AI model resource
EXAMPLES
$ heroku ai:models:call my_llm --app my-app --prompt "What is the meaning of life?"
$ heroku ai:models:call diffusion --app my-app --prompt "Generate an image of a sunset" --opts '{"quality":"hd"}' -o sunset.png
See code: src/commands/ai/models/call.ts
heroku ai:models:create MODEL_NAME
provision access to an AI model
USAGE
$ heroku ai:models:create MODEL_NAME -a <value> [--as <value>] [--confirm <value>] [-r <value>]
ARGUMENTS
MODEL_NAME name of AI model to provision access for
FLAGS
-a, --app=<value> (required) name of app to attach model to
-r, --remote=<value> git remote of app to use
--as=<value> alias of model resource
--confirm=<value> overwrite existing config vars or existing add-on aliases
DESCRIPTION
provision access to an AI model
EXAMPLES
# Provision access to an AI model and attach it to your app with a default name:
$ heroku ai:models:create claude-3-5-sonnet --app example-app
# Provision access to an AI model and attach it to your app with a custom name:
$ heroku ai:models:create stable-image-ultra --app example-app --as diffusion
See code: src/commands/ai/models/create.ts
heroku ai:models:destroy MODEL_RESOURCE
destroy an existing AI model resource
USAGE
$ heroku ai:models:destroy MODEL_RESOURCE -a <value> [-c <value>] [-f] [-r <value>]
ARGUMENTS
MODEL_RESOURCE resource ID or alias of model resource to destroy
FLAGS
-a, --app=<value> (required) app to run command against
-c, --confirm=<value> set to app name to bypass confirmation prompt
-f, --force allow destruction even if connected to other apps
-r, --remote=<value> git remote of app to use
DESCRIPTION
destroy an existing AI model resource
EXAMPLES
$ heroku ai:models:destroy claude-3-5-sonnet-acute-43973
See code: src/commands/ai/models/destroy.ts
heroku ai:models:detach MODEL_RESOURCE
detach a model resource from an app
USAGE
$ heroku ai:models:detach MODEL_RESOURCE -a <value> [-r <value>]
ARGUMENTS
MODEL_RESOURCE alias of model resource to detach
FLAGS
-a, --app=<value> (required) name of app to detach model resource from
-r, --remote=<value> git remote of app to use
DESCRIPTION
detach a model resource from an app
EXAMPLES
$ heroku ai:models:detach EXAMPLE_MODEL_ALIAS --app example-app
See code: src/commands/ai/models/detach.ts
heroku ai:models:info [MODEL_RESOURCE]
get current status of a specific AI model resource or all AI model resources attached to an app
USAGE
$ heroku ai:models:info [MODEL_RESOURCE] -a <value> [-r <value>]
ARGUMENTS
MODEL_RESOURCE resource ID or alias of model resource
FLAGS
-a, --app=<value> (required) app to run command against
-r, --remote=<value> git remote of app to use
DESCRIPTION
get current status of a specific AI model resource or all AI model resources attached to an app
EXAMPLES
$ heroku ai:models:info claude-3-5-sonnet-acute-04281 --app example-app
$ heroku ai:models:info --app example-app
See code: src/commands/ai/models/info.ts
heroku ai:models:list
list available AI models to provision access to
USAGE
$ heroku ai:models:list
DESCRIPTION
list available AI models to provision access to
ALIASES
$ heroku ai:models
EXAMPLES
$ heroku ai:models:list
See code: src/commands/ai/models/list.ts
heroku ai:tools:list [ADDON]
list all available AI tools
USAGE
$ heroku ai:tools:list [ADDON] [--json] [-a <value>]
ARGUMENTS
ADDON [default: heroku-inference] unique identifier or globally unique name of add-on
FLAGS
-a, --app=<value> app to list tools for
--json output in JSON format
DESCRIPTION
list all available AI tools
See code: src/commands/ai/tools/list.ts
Keywords
FAQs
Heroku CLI plugin for Heroku AI add-on
We found that @heroku/plugin-ai demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 188 open source maintainers collaborating on the project.
Package last updated on 15 Aug 2025
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Related posts
Product
Introducing Webhook Events for Pull Request Scans
Add real-time Socket webhook events to your workflows to automatically receive pull request scan results and security alerts in real time.
By Jeppe Hasseriis -  Oct 22, 2025
Research
Malicious NuGet Packages Typosquat Nethereum to Exfiltrate Wallet Keys
The Socket Threat Research Team uncovered malicious NuGet packages typosquatting the popular Nethereum project to steal wallet keys.
By Kirill Boychenko -  Oct 22, 2025