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

Action ID	Name	Description	Parameters
`analyze-prose`	Analyze Prose	Evaluates writing for quality with ratings and recommendations	None
`aphorisms`	Aphorisms	Finds and prints existing, known aphorisms	None
`change-tone`	Change the Tone	Changes text tone while preserving meaning	`tone`: Assertive, Friendly, Informal, Professional, Simple and direct
`correct-grammar`	Correct Grammar & Spelling	Fixes grammar and spelling errors	None
`cut-filler-words`	Cut filler words	Removes filler words for confident text	None
`fill-in`	Fill in	Completes partial text intelligently	None
`improve-writing`	Improve Writing	Refines text for clarity, coherence, grammar	None
`lengthen`	Lengthen	Expands text with additional details	None
`poll`	Poll	Generates engaging polls	None
`rewrite`	Rewrite	Rewrites text with fresh perspectives	None
`shorten`	Shorten	Condenses text while retaining essentials	None
`write-essay`	Write essay	Crafts well-structured essays	`input`: Topic/Instructions

💻 Code Actions

Action ID	Name	Description	Parameters
`act-code`	Act On Code	Modifies and improves code	`input`: Instructions
`document`	Document code	Documents code with comments	None
`explain-code`	Explain Code	Explains code and documentation	None
`fill-code`	Fill Code	Fills in missing code	None
`fix-code`	Fix Code	Fixes code errors	`input`: Error message
`language-gpt`	Language-GPT	Expert insights for programming languages	`input`: Question
`suggest-improvements`	Suggest code improvements	Analyzes code for enhancements	None
`transcode`	Transcode to other language	Converts code between languages	`language`: Target language

🌐 Translation Actions

Action ID	Name	Description	Parameters
`translate`	Translate	Translates text between languages	`language`: Arabic, Chinese, Dutch, English, Filipino, French, German, Indonesian, Italian, Japanese, Korean, Portuguese, Russian, Spanish, Vietnamese
`translate-to-english`	Translate to English	Translates any language to English	None
`translate-to-french`	Translate to French	Translates any language to French	None
`translate-to-spanish`	Translate to Spanish	Translates any language to Spanish	None

📊 Summarize Actions

Action ID	Name	Description	Parameters
`summarize-detailed`	Detailed	Comprehensive summary with overview, points, takeaways	None
`summarize-micro`	Micro	Concise, focused summaries	None
`summarize-newsletter`	Newsletter Summary	Extracts key newsletter updates	None

🔍 Extract Actions

Action ID	Name	Description	Parameters
`extract-mails`	Mails	Extracts email addresses	None
`extract-names`	Names	Extracts personal names	None
`extract-any`	People/Companies	Extracts personal/business info	None
`extract-predictions`	Predictions	Extracts predictions	None
`extract-recommendations`	Recommendations	Extracts recommendations	None
`extract-todo`	Tasks	Extracts actionable tasks	None
`extract-trends`	Trends	Extracts trends	None
`extract-wisdom`	Extract Wisdom	Extracts insights and interesting info	None

📋 Format Actions

Action ID	Name	Description	Parameters
`format-to-bullet-list`	Bullet list	Converts text to bullet list	None
`format-to-markdown-checklist`	Markdown checklist	Converts text to checklist	None
`format-to-markdown-table`	Markdown table	Converts text to table	None
`format-to-numbered-list`	Numbered list	Converts text to numbered list	None
`sort-az`	Sort A-Z	Sorts alphabetically ascending	None
`sort-za`	Sort Z-A	Sorts alphabetically descending	None

🎨 Create Actions

Action ID	Name	Description	Parameters
`create-alter-action`	Alter Action	Creates Alter Actions	`input`: Instructions
`create-charts`	Charts	Creates Recharts visualizations	`input`: Instructions
`create-diagrams`	Diagrams	Generates Mermaid diagrams	`input`: Instructions
`create-html`	HTML page	Creates HTML pages	`input`: Instructions
`create-images`	Images	Generates AI images (Flux, Ideogram)	`input`: Instructions
`create-maps`	Maps	Creates LeafletJS maps	`input`: Instructions
`create-presentations`	HTML Presentations	Generates slide presentations	`input`: Instructions
`create-react-app`	Tailwind React App	Creates React apps	`input`: Instructions

🔎 Explain Actions

Action ID	Name	Description	Parameters
`analyze-paper`	Analyze Paper	Analyzes research papers	None
`explain-selection`	Explain	Explains complex concepts simply	None
`hidden-message`	Hidden message	Uncovers hidden messages in text	None

🔀 Git Actions

Action ID	Name	Description	Parameters
`git-commit`	Commit message	Generates commit messages	None
`git-review`	Review	Reviews code changes	None
`git-summarize`	Summarize	Summarizes Git commits	None
`pull-request`	Pull Request	Creates PR descriptions	None

🧠 Co-Intelligence Actions (Expert GPTs)

Action ID	Name	Description	Parameters
`business-strategist-gpt`	Business Strategy Expert	Business strategy advice	`input`: Question
`children-educator`	Children Educator	Early childhood education guidance	`input`: Question
`e-commerce-strategist-gpt`	E-commerce Strategy Expert	E-commerce strategy advice	`input`: Question
`hrmanager-gpt`	HR Manager Expert	HR management guidance	`input`: Question
`marketer-gpt`	Marketing Expert	Marketing strategy advice	`input`: Question
`mental-models-gpt`	Mental Models Expert	Mental models for decision-making	`input`: Question
`software-architect-gpt`	Software Architect Expert	Software architecture guidance	`input`: Question

💬 General Actions

Action ID	Name	Description	Parameters
`ask-anything`	Ask Anything	Open-ended AI conversation	`input`: Instructions
`ask-web`	Search the web	Web search with sources	`input`: Question

📧 Email Actions

Action ID	Name	Description	Parameters
`mail-draft`	Mail Draft	Creates email drafts	`input`: Instructions
`mail-multi-summary`	Multiconversation summary	Summarizes multiple email threads	None
`mail-reply`	Mail Reply	Generates email replies	`answerType`: Any updates?, Doesn't work, I don't know, etc.
`mail-summary`	Thread summary	Summarizes email threads	None

📱 Social Media Actions

Action ID	Name	Description	Parameters
`linkedin-post`	Linkedin Post	Creates LinkedIn posts	None
`linkedin-reply`	Linkedin Reply	Generates LinkedIn replies	None
`twitter-post`	Twitter Post	Creates engaging tweets	None
`twitter-reply`	Twitter Reply	Generates tweet replies	None
`twitter-thread`	Twitter Thread	Creates Twitter threads	None

📺 YouTube Actions

Action ID	Name	Description	Parameters
`youtube-hidden-message`	Youtube hidden message	Analyzes videos for hidden messages	None
`youtube-summarize-detailed`	Youtube detailed Summary	Comprehensive video summaries	None
`youtube-summarize-micro`	Youtube micro summary	Quick video summaries	None

🎯 Other Actions

Action ID	Name	Description	Parameters
`create-a-keynote-deck`	Generate Keynote slides	Generates Keynote presentations	`input`: Instructions
`edit-a-keynote-deck`	Edit Keynote slide	Edits Keynote slides	`input`: Instructions
`translate-the-deck`	Translate the deck	Translates Keynote presentations	`language`: Target language
`write-presenter-notes`	Write presenter notes	Creates presenter notes	None
`meeting-scribe`	Meeting Report	Converts transcripts to notes	None
`spreadsheet-formula`	Spreadsheet Formula	Creates spreadsheet formulas	`input`: Instructions
`user-story`	User Story	Creates agile user stories	None

Category	Description	Action Count
`code`	Programming and development	8
`writing`	Text editing and creation	12
`translate`	Language translation	4
`summarize`	Content summarization	2
`extract`	Information extraction	7
`format`	Text formatting	6
`create`	Content creation	8
`explain`	Explanation and analysis	4
`git`	Git version control	4
`co-intelligences`	Expert AI assistants	7

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

alter-action-trigger