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 writingURL Format
All Alter actions use the x-callback-url format:
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-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 |
Categories
| 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=FrenchFrom 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-imagesNotes
- Actions operate on currently selected text/files in Alter
- Parameters are URL-encoded automatically
- Actions with
hasParameters: falsetypically need selected content in Alter - The
opencommand is used on macOS to trigger x-callback-urls