Alter Action Trigger

Trigger Alter actions via x-callback-urls from Clawdbot or the command line.

Quick Start

# Trigger an action directly
node index.js trigger ask-anything --input "What is AI?"

# Find actions with natural language
node index.js find "summarize video"

# List all actions in a category
node index.js list --category writing

URL Format

All Alter actions use the x-callback-url format:

alter://action/{action-id}?input={encoded-text}&param={value}

Functions

triggerAction(actionId, input, params)

Triggers an Alter action via x-callback-url.

findActions(query)

Finds actions matching a natural language query.

listActions(category)

Lists all actions, optionally filtered by category.

getActionInfo(actionId)

Returns detailed information about a specific action.

buildCallbackUrl(actionId, input, params)

Builds an x-callback-url without executing it.

Available Actions Reference

📝 Writing Actions

💻 Code Actions

🌐 Translation Actions

📊 Summarize Actions

🔍 Extract Actions

📋 Format Actions

🎨 Create Actions

🔎 Explain Actions

🔀 Git Actions

🧠 Co-Intelligence Actions (Expert GPTs)

💬 General Actions

📧 Email Actions

📱 Social Media Actions

📺 YouTube Actions

🎯 Other Actions

Categories

Usage Examples

From Clawdbot

// Trigger ask-anything with a question
const { triggerAction } = require('./index.js');
triggerAction('ask-anything', 'What is machine learning?');

// Find actions for "translate text"
const { findActions } = require('./index.js');
const matches = findActions('translate text');
console.log(matches[0]); // { id: 'translate', name: 'Translate', ... }

// Build URL without triggering
const { buildCallbackUrl } = require('./index.js');
const url = buildCallbackUrl('translate', null, { language: 'French' });
// -> alter://action/translate?language=French

From Command Line

# Ask a question
node index.js trigger ask-anything --input "Explain quantum computing"

# Translate with specific language
node index.js trigger translate --param "language=Japanese"

# Fix code with error message
node index.js trigger fix-code --input "TypeError: undefined is not a function"

# Change tone
node index.js trigger change-tone --param "tone=Professional"

# Search for actions
node index.js find "create a chart"

# Get action details
node index.js info create-images

Notes

• Actions operate on currently selected text/files in Alter
• Parameters are URL-encoded automatically
• Actions with hasParameters: false typically need selected content in Alter
• The open command is used on macOS to trigger x-callback-urls