What are actions?
When your AI identifies something that needs doing in an external system (post a GitHub comment, close a Linear issue), it proposes an action. You review and approve before anything executes. Nothing happens without your sign-off.
How it works
- Your AI (or a trigger) proposes an action via
propose_action
- The action enters a pending queue
- You review pending actions via
list_pending_actions
- You approve or reject via
decide_action
- Approved actions execute immediately via the integration adapter
Supported action types
| Action Type | Provider | What it does |
|---|
github_comment | GitHub | Posts a comment on an issue or pull request |
linear_close | Linear | Transitions a Linear issue to “Done” state |
Proposing an action
Ask your AI to propose an action in natural language:
“3ngram: Propose a GitHub comment on owner/repo#42 saying ‘This has been resolved in the latest deploy’”
Under the hood, this calls propose_action with these parameters:
| Parameter | Required | Description |
|---|
action_type | Yes | github_comment or linear_close |
target_provider | Yes | github or linear |
target_ref | Yes | Provider reference (e.g. owner/repo#123 for GitHub) |
payload_json | Yes | JSON with action data (e.g. {"body": "comment text"}) |
reason | Yes | Why this action is being proposed |
source_memory_id | No | Memory ID that prompted this action |
Reviewing and deciding
List pending actions:
“3ngram: Show my pending actions”
This returns all actions awaiting your decision, with their type, target, reason, and proposed payload.
Approve an action (executes immediately):
“3ngram: Approve action ”
Reject an action:
“3ngram: Reject action ”
You can filter actions by status (pending, approved, rejected, executed, failed) and by provider.
Triggers + Actions
Triggers can automatically propose actions when events fire. For example, a trigger could propose closing a Linear issue whenever a related commitment is resolved. See Triggers for setup details.
Actions require a paid subscription and a connected integration (GitHub or Linear). The action uses your integration credentials.
