# CrowTerminal

AI-powered command line assistant with memory and automation capabilities for developers

- **Category:** developer tools
- **Auth:** API_KEY, BASIC
- **Composio Managed App Available?** N/A
- **Tools:** 27
- **Triggers:** 0
- **Slug:** `CROWTERMINAL`
- **Version:** 20260312_00

## Tools

### Analyze Agent Engagement

**Slug:** `CROWTERMINAL_ANALYZE_ENGAGEMENT`

Tool to analyze engagement correlation for every field in your agent's markdown. Use when you need to understand which agent configuration fields drive engagement and get specific recommendations for improvement. Returns similarity to best/worst performing versions and field-by-field analysis.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `agent_md` | object | Yes | The agent's current markdown/skill data to analyze. This is a dictionary containing agent configuration fields like name, description, skills, personality, etc. |
| `client_id` | string | Yes | The client ID to analyze engagement for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Compare Agent Markdown

**Slug:** `CROWTERMINAL_COMPARE_MD`

Tool to compare your agent's markdown directly with all stored versions. Returns field differences showing which values differ across versions, lists missing fields not present in your current data, and provides version counts. Use when you need to understand how your current agent configuration compares to historical versions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `agentMd` | object | Yes | The agent's current markdown/skill data to compare against all stored versions. Contains metadata about content style, hooks, engagement, and posting schedule. |
| `clientId` | string | Yes | The client ID to compare markdown versions for. Used to identify which client's historical data to compare against. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Webhook

**Slug:** `CROWTERMINAL_CREATE_WEBHOOK`

Tool to register a new webhook for receiving real-time event notifications from CrowTerminal. Use when you need to set up asynchronous notifications for events like skill updates, data ingestion, or validation blocks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The webhook URL endpoint to receive event notifications. Must be a valid HTTPS URL accessible from the internet. |
| `events` | array | Yes | Array of event types to subscribe to. Available events: 'skill.updated' (triggered when a skill is updated), 'data.ingested' (triggered when data is ingested), 'validation.blocked' (triggered when validation is blocked). |
| `secret` | string | No | Optional secret key for webhook signature verification. If provided, this secret will be used to sign webhook payloads for security validation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Webhook

**Slug:** `CROWTERMINAL_DELETE_WEBHOOK`

Tool to delete an existing webhook registration. Use when you need to remove a webhook that is no longer needed or should be replaced.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | string | Yes | The unique identifier of the webhook to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get BYOK Platform Intelligence

**Slug:** `CROWTERMINAL_GET_BYOK_PLATFORM_INTEL`

Tool to get algorithm insights for TikTok, Instagram, and YouTube without client-specific context. Use when you need platform intelligence data for BYOK (Bring Your Own Key) analysis workflows. This endpoint provides raw contextual algorithm data without triggering LLM inference charges.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Client Memory Changelog

**Slug:** `CROWTERMINAL_GET_CLIENT_MEMORY_CHANGELOG`

Retrieve human-readable change history for a client's memory. Provides a narrative view of how the client's skill data has evolved over time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `client_id` | string | Yes | The unique identifier of the client whose memory changelog to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Client Memory Pattern

**Slug:** `CROWTERMINAL_GET_CLIENT_MEMORY_PATTERN`

Tool to track a specific field over time for trend analysis. Use when you need to understand how a particular metric evolved across versions or time periods.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `field` | string | No | The field name to track over time (e.g., avgEngagement). If not specified, returns patterns for all tracked fields. |
| `client_id` | string | Yes | The client ID to retrieve memory pattern for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Components Status

**Slug:** `CROWTERMINAL_GET_COMPONENTS_STATUS`

Tool to get detailed status of each CrowTerminal service component. Returns current health status, latency, and summary statistics for all monitored components (database, cache, APIs, webhooks). Use when checking system health or diagnosing service issues.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Data Types

**Slug:** `CROWTERMINAL_GET_DATA_TYPES`

Tool to retrieve valid data types for ingestion across platforms. Returns available data types for TikTok, Instagram, and YouTube that can be used for data ingestion operations.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Recent Incidents

**Slug:** `CROWTERMINAL_GET_INCIDENTS`

Tool to retrieve list of recent incidents from CrowTerminal with duration and affected components. Use when you need to check system status, monitor service health, or investigate recent outages or degradations.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Platform Intelligence

**Slug:** `CROWTERMINAL_GET_PLATFORM_INTEL`

Tool to retrieve algorithm insights for TikTok, Instagram, and YouTube. Returns platform-wide intelligence about content algorithm behavior and optimization strategies. Use when you need current platform algorithm trends and recommendations.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Sandbox Client

**Slug:** `CROWTERMINAL_GET_SANDBOX_CLIENT`

Tool to get mock client data for testing in the sandbox environment. Use when you need to test client-related functionality without affecting real data. No authentication required for sandbox endpoints.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Sandbox Memory

**Slug:** `CROWTERMINAL_GET_SANDBOX_MEMORY`

Tool to retrieve mock memory/skill data for testing purposes. Use when you need to test memory retrieval without affecting real data or requiring authentication. Part of the sandbox testing environment.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Service Status

**Slug:** `CROWTERMINAL_GET_STATUS`

Retrieve CrowTerminal service status including overall health, component metrics, and uptime data. Use when you need to check the operational status of CrowTerminal services or monitor system health. No authentication required.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Status History

**Slug:** `CROWTERMINAL_GET_STATUS_HISTORY`

Tool to get 7-day uptime data points ready for visualization and charting. Use when you need historical uptime metrics for monitoring dashboards or status displays.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Uptime Data

**Slug:** `CROWTERMINAL_GET_UPTIME`

Tool to retrieve historical uptime data for CrowTerminal agents. Use when you need to check system reliability, view uptime percentages for 24h/7d periods, or review recent service incidents.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Ingest Analytics Data

**Slug:** `CROWTERMINAL_INGEST_BULK_DATA`

Tool to bulk ingest up to 50 analytics data points at once to CrowTerminal. Use when you need to efficiently push large amounts of platform analytics data for content creators across social media platforms. Ideal for batch uploads of retention, engagement, views, and other metrics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `items` | array | Yes | Array of data items to ingest. Maximum 50 items per request. Each item represents analytics data for a specific creator/platform/content combination. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Ingest Analytics Data

**Slug:** `CROWTERMINAL_INGEST_DATA`

Tool to ingest platform analytics data from TikTok Studio, Instagram Insights, or YouTube Analytics. Use when you need to push retention curves, demographics, traffic sources, or other engagement metrics for analysis. Supports both video-specific and channel-level data ingestion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | The actual analytics data payload. Structure varies by dataType. For retention: use 'curve' array with 'second' and 'retention' fields. For demographics: include age/gender/location distributions. For traffic_sources: include source names and percentages. |
| `videoId` | string | No | Optional video ID for video-specific analytics data. Required when ingesting metrics for a specific video rather than channel-level data. |
| `clientId` | string | Yes | The client ID for identifying the data source. |
| `dataType` | string | Yes | Type of analytics data being ingested. Common types include: 'retention' (audience retention curves), 'demographics' (age/gender/location data), 'traffic_sources' (referral sources), 'engagement' (likes/comments/shares), 'performance' (views/impressions). |
| `platform` | string ("TIKTOK" | "INSTAGRAM" | "YOUTUBE") | Yes | The platform from which the analytics data originates (TikTok, Instagram, or YouTube). |
| `confidence` | number | No | Confidence level of the ingested data (0.0 to 1.0). Higher values indicate more reliable data. Useful for indicating data quality from OCR or parsing operations. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Webhooks

**Slug:** `CROWTERMINAL_LIST_WEBHOOKS`

Tool to list all registered webhooks for the authenticated agent. Use when you need to view all webhook subscriptions and their configurations.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Ping CrowTerminal Service

**Slug:** `CROWTERMINAL_PING_CROWTERMINAL`

Tool to check CrowTerminal service availability via a simple ping endpoint. Use when you need to verify the service is online and responding. Returns a pong confirmation with a timestamp.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Read Memory

**Slug:** `CROWTERMINAL_READ_BULK_MEMORY`

Tool to read memory for multiple clients at once (up to 50). Use when you need to efficiently retrieve memory data for multiple creators in a single API call.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `clientIds` | array | Yes | Array of client IDs to retrieve memory for (maximum 50 clients per request) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Register Agent

**Slug:** `CROWTERMINAL_REGISTER_AGENT`

Tool to self-register a new agent and obtain an API key. Use when you need to create a new agent identity in CrowTerminal. No authentication required for this endpoint. Rate limited to 5 requests per hour per IP address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `agentName` | string | Yes | Name of the agent to register. Must be unique and descriptive. |
| `agentDescription` | string | No | Optional description of the agent's purpose or functionality. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Sandbox Engagement Analysis

**Slug:** `CROWTERMINAL_RUN_SANDBOX_ENGAGEMENT_ANALYSIS`

Tool to run mock engagement analysis in the CrowTerminal sandbox environment. Use when you need to test the engagement analysis workflow without affecting real data or when developing and validating agent configurations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `agentMd` | object | Yes | Agent metadata object containing configuration for mock engagement analysis. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Test Webhook

**Slug:** `CROWTERMINAL_TEST_WEBHOOK`

Tool to test a webhook URL by sending a test payload. Use when you need to verify that a webhook endpoint is properly configured and can receive requests.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The webhook URL to test. This URL will receive a test payload to verify it's properly configured |
| `secret` | string | No | Optional secret for signature generation. If provided, the webhook will be signed with this secret |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Webhook

**Slug:** `CROWTERMINAL_UPDATE_WEBHOOK`

Tool to update an existing webhook configuration in CrowTerminal. Use when you need to modify webhook URL, change event subscriptions, or enable/disable a webhook.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | No | The new webhook URL endpoint where events will be sent. Must be a valid HTTPS URL. |
| `events` | array | No | Array of event types to subscribe to. Common events include 'skill.updated', 'data.ingested', 'validation.blocked'. |
| `is_active` | boolean | No | Enable or disable the webhook. Set to true to activate, false to deactivate. |
| `webhook_id` | string | Yes | The unique identifier of the webhook to update. Must be a valid webhook ID from CrowTerminal. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Validate Proposed Changes

**Slug:** `CROWTERMINAL_VALIDATE_PROPOSED_CHANGES`

Tool to validate proposed changes against historical data before updating memory. Use when you need to check if proposed changes contradict historical patterns and receive warnings or recommendations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `clientId` | string | Yes | The client ID to validate changes against |
| `proposedChanges` | array | Yes | Array of proposed changes to validate against historical patterns |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Validate Sandbox

**Slug:** `CROWTERMINAL_VALIDATE_SANDBOX`

Tool to mock validation endpoint for testing in sandbox. Use when you need to test validation logic. Send 'tutorial' in proposedChanges to get a blocked response.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `proposedChanges` | array | Yes | Array of proposed changes to validate. Send 'tutorial' as one of the values to get a blocked response for testing purposes. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |