CrowTerminal

Provides persistent, versioned memory and engagement analysis for AI agents supporting creators and influencers across social media platforms.

CrowTerminal - External Brain for AI Agents

"Agents are ephemeral. We are persistent."

While your agent stores 10-50 lines of context, CrowTerminal stores 6 months of versioned history for each creator.

What It Does

CrowTerminal is a persistent memory layer for AI agents working with influencers/creators:

• Versioned Memory - Track what works across sessions (hook patterns, engagement, posting times)
• Pattern Detection - See trends over months, not single data points
• Engagement Analysis - Know what configuration performed best historically
• Validation - Check if your changes will repeat past mistakes
• Data Ingestion - Push platform data we can't access (retention curves, demographics)
• LLM-Native API - Schema discovery, semantic field aliases, natural language queries

Quick Start

1. Get API Key (Self-Registration)

bash

curl -X POST "https://api.crowterminal.com/api/agent/register" \
  -H "Content-Type: application/json" \
  -d '{"agentName": "OpenClaw", "agentDescription": "My personal AI agent"}'

Save the returned API key as CROWTERMINAL_API_KEY.

2. Read Creator Memory

bash

curl https://api.crowterminal.com/api/agent/memory/client_123 \
  -H "Authorization: Bearer $CROWTERMINAL_API_KEY"

Returns versioned skill data:

json

{
  "version": 47,
  "skill": {
    "primaryNiche": "fitness",
    "hookPatterns": ["confession", "transformation"],
    "avgEngagement": 4.2,
    "bestPostingTimes": [{"day": 2, "hour": 7, "score": 0.89}]
  }
}

Key Endpoints

Schema Discovery (LLM-Friendly)

These endpoints help agents understand what data is available without hardcoding field names:

Endpoint	Description
GET /memory/schema	Full schema with field descriptions, types, and semantic aliases
GET /memory/schema/:category	Schema filtered by category (content, performance, timing, audience, history)
POST /memory/resolve	Resolve natural language queries to field names

Example: Discover available fields

bash

curl https://api.crowterminal.com/api/agent/memory/schema \
  -H "Authorization: Bearer $CROWTERMINAL_API_KEY"

Returns field definitions with semantic aliases:

json

{
  "fields": {
    "avgEngagement": {
      "type": "number",
      "description": "Average engagement rate",
      "aliases": ["engagement", "engagement rate", "interaction rate"],
      "category": "performance"
    }
  }
}

Smart Query (Natural Language)

Query data using natural language instead of exact field names:

Endpoint	Description
POST /memory/:clientId/query	Query with natural language ("engagement and hooks")
GET /memory/:clientId/overview	Human-readable summary of the creator
GET /memory/:clientId/changes	Natural language summary of recent changes
GET /memory/:clientId/insights	AI-friendly performance insights

Example: Natural language query

bash

curl -X POST "https://api.crowterminal.com/api/agent/memory/client_123/query" \
  -H "Authorization: Bearer $CROWTERMINAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "engagement and hooks"}'

Returns matched data:

json

{
  "results": {
    "matchedFields": ["avgEngagement", "hookPatterns"],
    "data": {
      "avgEngagement": 4.2,
      "hookPatterns": ["confession", "POV"]
    },
    "context": "avgEngagement: Average engagement rate; hookPatterns: Effective hook types"
  }
}

Example: Get natural language overview

bash

curl https://api.crowterminal.com/api/agent/memory/client_123/overview \
  -H "Authorization: Bearer $CROWTERMINAL_API_KEY"

Returns:

json

{
  "overview": "FitnessGuru is a fitness creator averaging 125,000 views per video with 4.2% engagement and is currently growing. Their best-performing hooks are: confession, transformation, POV."
}

Memory Layer (Core)

Endpoint	Description
GET /memory/:clientId	Current skill version
GET /memory/:clientId/versions	Version history
GET /memory/:clientId/diff?from=5&to=10	Compare versions
GET /memory/:clientId/pattern?field=engagement	Track field over time with trend analysis
POST /memory/:clientId/validate	Check before changing
POST /memory/:clientId/engagement-analysis	THE KILLER ENDPOINT

The Killer Endpoint: Engagement Analysis

Send your current learnings, get back what configuration performed best:

bash

curl -X POST "https://api.crowterminal.com/api/agent/memory/client_123/engagement-analysis" \
  -H "Authorization: Bearer $CROWTERMINAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agentMd": {
      "hookPatterns": ["confession"],
      "contentStyle": "casual"
    }
  }'

Returns:

json

{
  "overallStats": {
    "peakEngagement": 6.2,
    "yourSimilarityToTop": "65%"
  },
  "recommendations": [
    "Change hookPatterns to [\"POV\",\"confession\"] (+51% potential)"
  ]
}

Data Ingestion (Push Your Data)

Push platform data we can't access via API:

bash

curl -X POST "https://api.crowterminal.com/api/agent/data/ingest" \
  -H "Authorization: Bearer $CROWTERMINAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "client_123",
    "platform": "TIKTOK",
    "dataType": "retention",
    "data": {
      "retentionCurve": [100, 95, 88, 75, 60, 45, 30],
      "avgWatchTime": 12.5
    }
  }'

Webhooks (Async Notifications)

bash

curl -X POST "https://api.crowterminal.com/api/agent/webhooks" \
  -H "Authorization: Bearer $CROWTERMINAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/webhook",
    "events": ["skill.updated", "data.ingested"]
  }'

Service Status (No Auth)

bash

curl https://api.crowterminal.com/api/agent/status

Sandbox (Test Without Auth)

Test endpoints without affecting real data:

Memory & Schema:

• GET /api/agent/sandbox/client - Mock client data
• GET /api/agent/sandbox/memory - Mock memory/skill
• GET /api/agent/sandbox/schema - Schema discovery
• POST /api/agent/sandbox/resolve - Resolve field aliases

Smart Query:

• POST /api/agent/sandbox/query - Natural language queries
• GET /api/agent/sandbox/overview - Creator overview
• GET /api/agent/sandbox/changes - Recent changes summary
• GET /api/agent/sandbox/insights - Performance insights

Analysis:

• POST /api/agent/sandbox/validate - Validate changes
• POST /api/agent/sandbox/engagement-analysis - Engagement analysis
• POST /api/agent/sandbox/ingest - Data ingestion

Why Use CrowTerminal?

1. Your agent learns → forgets → relearns - We remember
2. One bad video ≠ pattern change - We track across versions
3. Data you can't get via API - We accept it via ingestion
4. BYOK - Use your own LLM, we just provide context
5. LLM-Native - No hardcoding field names, use natural language queries
6. Self-Documenting - Schema endpoint tells you what data exists

Pricing

FREE during beta. We want agents to test and give feedback.

Tier	Price
Memory Read/Write	FREE
Data Ingestion	FREE
BYOK (your LLM)	FREE
Full Service	FREE

Documentation

• Full Docs: https://crowterminal.com/llms.txt
• MCP Manifest: https://crowterminal.com/.well-known/mcp.json
• OpenAPI: https://api.crowterminal.com/api/docs.json
• SDKs: Python (pip install crowterminal), TypeScript (npm install crowterminal)

Support

• Email: [e-mail]
• GitHub: https://github.com/WillNigri/FluxOps

---

"Your agent's external hard drive. Because context windows aren't long-term memory."