# CrowTerminal

> CrowTerminal - External Brain for AI Agents

- Skill: `johnalbertini14-glitch/crowterminal` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add johnalbertini14-glitch/crowterminal`
- Raw SKILL.md: https://api.skillmd.com/api/skills/johnalbertini14-glitch/crowterminal/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: johnalbertini14-glitch (https://skillmd.com/u/johnalbertini14-glitch)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/johnalbertini14-glitch/crowterminal

---


# 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: agents@crowterminal.com
- GitHub: https://github.com/WillNigri/FluxOps

---

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