Protocol Launcher

Alter ​

Alter is a macOS AI automation app. Protocol Launcher allows you to generate URLs for triggering Alter actions from other apps.

Usage ​

There are two ways to use this library:

  • On-Demand import from subpaths enables tree-shaking and keeps bundles small.
  • Full Import from the root package is convenient but includes all app modules.

Pick On-Demand for production builds; Full Import is fine for quick scripts or demos.

Select Installation Method

On-Demand
Recommended. Optimized for production.
Full Import
Convenient. Good for quick scripts.

URL Methods ​

Alter's official URL Callbacks guide documents alter://... URLs copied from the Action Editor's URL Callback section. It also shows action callback examples under alter://action/... with optional input query data. This module keeps that boundary: use Alter-generated URLs and only add the documented input parameter when needed.

Open Callback URL ​

Return an Alter callback URL exactly as copied from Alter. Use this when Alter already generated the full URL for the action.

On-Demand
ts
import { openCallbackUrl } from 'protocol-launcher/alter'

const url = openCallbackUrl({
  url: 'alter://action/business-strategist-gpt',
})

Run Generated Action ​

Return an Alter-generated action callback URL and optionally add the documented input query parameter.

On-Demand
ts
import { runGeneratedAction } from 'protocol-launcher/alter'

const url = runGeneratedAction({
  url: 'alter://action/ask-web',
  input: 'What is Alter MacOS',
})

const urlWithoutInput = runGeneratedAction({
  url: 'alter://action/business-strategist-gpt',
})

const businessStrategistUrl = runGeneratedAction({
  url: 'alter://action/business-strategist-gpt',
  input: 'Explain Red Ocean Strategy',
})

Generated URLs ​

ts
openCallbackUrl({ url: 'alter://action/business-strategist-gpt' })
// => 'alter://action/business-strategist-gpt'

runGeneratedAction({ url: 'alter://action/ask-web', input: 'What is Alter MacOS' })
// => 'alter://action/ask-web?input=What+is+Alter+MacOS'

runGeneratedAction({ url: 'alter://action/business-strategist-gpt' })
// => 'alter://action/business-strategist-gpt'

runGeneratedAction({
  url: 'alter://action/business-strategist-gpt',
  input: 'Explain Red Ocean Strategy',
})
// => 'alter://action/business-strategist-gpt?input=Explain+Red+Ocean+Strategy'

Official Documentation ​