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

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=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