Alter Action Trigger
Trigger Alter actions via x-callback-urls from Clawdbot or the command line.
Quick Start
bash # 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:
text alter://action/{action-id}?input={encoded-text}¶m={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-proseAnalyze Prose Evaluates writing for quality with ratings and recommendations None aphorismsAphorisms Finds and prints existing, known aphorisms None change-toneChange the Tone Changes text tone while preserving meaning tone: Assertive, Friendly, Informal, Professional, Simple and directcorrect-grammarCorrect Grammar & Spelling Fixes grammar and spelling errors None cut-filler-wordsCut filler words Removes filler words for confident text None fill-inFill in Completes partial text intelligently None improve-writingImprove Writing Refines text for clarity, coherence, grammar None lengthenLengthen Expands text with additional details None pollPoll Generates engaging polls None rewriteRewrite Rewrites text with fresh perspectives None shortenShorten Condenses text while retaining essentials None write-essayWrite essay Crafts well-structured essays input: Topic/Instructions
💻 Code Actions
Action ID Name Description Parameters act-codeAct On Code Modifies and improves code input: InstructionsdocumentDocument code Documents code with comments None explain-codeExplain Code Explains code and documentation None fill-codeFill Code Fills in missing code None fix-codeFix Code Fixes code errors input: Error messagelanguage-gptLanguage-GPT Expert insights for programming languages input: Questionsuggest-improvementsSuggest code improvements Analyzes code for enhancements None transcodeTranscode to other language Converts code between languages language: Target language
🌐 Translation Actions
Action ID Name Description Parameters translateTranslate Translates text between languages language: Arabic, Chinese, Dutch, English, Filipino, French, German, Indonesian, Italian, Japanese, Korean, Portuguese, Russian, Spanish, Vietnamesetranslate-to-englishTranslate to English Translates any language to English None translate-to-frenchTranslate to French Translates any language to French None translate-to-spanishTranslate to Spanish Translates any language to Spanish None
📊 Summarize Actions
Action ID Name Description Parameters summarize-detailedDetailed Comprehensive summary with overview, points, takeaways None summarize-microMicro Concise, focused summaries None summarize-newsletterNewsletter Summary Extracts key newsletter updates None
🔍 Extract Actions
Action ID Name Description Parameters extract-mailsMails Extracts email addresses None extract-namesNames Extracts personal names None extract-anyPeople/Companies Extracts personal/business info None extract-predictionsPredictions Extracts predictions None extract-recommendationsRecommendations Extracts recommendations None extract-todoTasks Extracts actionable tasks None extract-trendsTrends Extracts trends None extract-wisdomExtract Wisdom Extracts insights and interesting info None
📋 Format Actions
Action ID Name Description Parameters format-to-bullet-listBullet list Converts text to bullet list None format-to-markdown-checklistMarkdown checklist Converts text to checklist None format-to-markdown-tableMarkdown table Converts text to table None format-to-numbered-listNumbered list Converts text to numbered list None sort-azSort A-Z Sorts alphabetically ascending None sort-zaSort Z-A Sorts alphabetically descending None
🎨 Create Actions
Action ID Name Description Parameters create-alter-actionAlter Action Creates Alter Actions input: Instructionscreate-chartsCharts Creates Recharts visualizations input: Instructionscreate-diagramsDiagrams Generates Mermaid diagrams input: Instructionscreate-htmlHTML page Creates HTML pages input: Instructionscreate-imagesImages Generates AI images (Flux, Ideogram) input: Instructionscreate-mapsMaps Creates LeafletJS maps input: Instructionscreate-presentationsHTML Presentations Generates slide presentations input: Instructionscreate-react-appTailwind React App Creates React apps input: Instructions
🔎 Explain Actions
Action ID Name Description Parameters analyze-paperAnalyze Paper Analyzes research papers None explain-selectionExplain Explains complex concepts simply None hidden-messageHidden message Uncovers hidden messages in text None
🔀 Git Actions
Action ID Name Description Parameters git-commitCommit message Generates commit messages None git-reviewReview Reviews code changes None git-summarizeSummarize Summarizes Git commits None pull-requestPull Request Creates PR descriptions None
🧠 Co-Intelligence Actions (Expert GPTs)
Action ID Name Description Parameters business-strategist-gptBusiness Strategy Expert Business strategy advice input: Questionchildren-educatorChildren Educator Early childhood education guidance input: Questione-commerce-strategist-gptE-commerce Strategy Expert E-commerce strategy advice input: Questionhrmanager-gptHR Manager Expert HR management guidance input: Questionmarketer-gptMarketing Expert Marketing strategy advice input: Questionmental-models-gptMental Models Expert Mental models for decision-making input: Questionsoftware-architect-gptSoftware Architect Expert Software architecture guidance input: Question
💬 General Actions
Action ID Name Description Parameters ask-anythingAsk Anything Open-ended AI conversation input: Instructionsask-webSearch the web Web search with sources input: Question
📧 Email Actions
Action ID Name Description Parameters mail-draftMail Draft Creates email drafts input: Instructionsmail-multi-summaryMulticonversation summary Summarizes multiple email threads None mail-replyMail Reply Generates email replies answerType: Any updates?, Doesn't work, I don't know, etc.mail-summaryThread summary Summarizes email threads None
📱 Social Media Actions
Action ID Name Description Parameters linkedin-postLinkedin Post Creates LinkedIn posts None linkedin-replyLinkedin Reply Generates LinkedIn replies None twitter-postTwitter Post Creates engaging tweets None twitter-replyTwitter Reply Generates tweet replies None twitter-threadTwitter Thread Creates Twitter threads None
📺 YouTube Actions
Action ID Name Description Parameters youtube-hidden-messageYoutube hidden message Analyzes videos for hidden messages None youtube-summarize-detailedYoutube detailed Summary Comprehensive video summaries None youtube-summarize-microYoutube micro summary Quick video summaries None
🎯 Other Actions
Action ID Name Description Parameters create-a-keynote-deckGenerate Keynote slides Generates Keynote presentations input: Instructionsedit-a-keynote-deckEdit Keynote slide Edits Keynote slides input: Instructionstranslate-the-deckTranslate the deck Translates Keynote presentations language: Target languagewrite-presenter-notesWrite presenter notes Creates presenter notes None meeting-scribeMeeting Report Converts transcripts to notes None spreadsheet-formulaSpreadsheet Formula Creates spreadsheet formulas input: Instructionsuser-storyUser Story Creates agile user stories None
Categories
Category Description Action Count codeProgramming and development 8 writingText editing and creation 12 translateLanguage translation 4 summarizeContent summarization 2 extractInformation extraction 7 formatText formatting 6 createContent creation 8 explainExplanation and analysis 4 gitGit version control 4 co-intelligencesExpert AI assistants 7
Usage Examples
From Clawdbot
javascript // 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
bash # 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
