alter-actions

---
name: alter-action-trigger
description: Trigger Alter macOS app actions via x-callback-urls. Catalog of 84+ actions including ask-anything, translate, summarize, grammar correction, and more.
metadata: {"clawdbot":{"requires":{"os":["darwin"]},"emoji":"🌀"}}
user-invocable: true
homepage: https://alterhq.com/blog/alter-callback-urls-guide
---

# 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:
```
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 | C