Directus CMS

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Kismetkanceled/geniehelper/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

• Headless CMS: RESTful API for all application data
• Authentication: User management, JWT tokens, role-based access control
• Collections: 11 core collections for creators, media, jobs, and platform data
• Flows: Low-code automation workflows (scraping, media processing, notifications)
• Admin Panel: Visual interface for data management and debugging

• Port: 8055 (proxied to /api/directus/ in production)
• Process: pm2 agentx-cms
• Admin URL: https://geniehelper.com/admin (iframe in dashboard)

​

Architecture Integration

​

Data Flow

React Dashboard → /api/directus/* → Directus REST API (port 8055)
                                        ↓
                          PostgreSQL Collections (11 tables)
                                        ↓
              ← Directus Flows → Media Worker (BullMQ) → Stagehand
                                        ↓
            AnythingLLM Agent ← Directus MCP (17 tools)

​

MCP Integration

User: "How many posts did I schedule this week?"

Agent:
1. Uses read-items tool on scheduled_posts collection
2. Filters by date_created >= 7 days ago
3. Returns count + summary

​

Key Collections

​

1. creator_profiles

​

2. scraped_media

​

3. scheduled_posts

​

4. media_jobs

​

5. hitl_sessions

​

6. platform_sessions

​

7. taxonomy_dimensions

1. Intimacy Level
2. Production Quality
3. Content Type
4. Audience Appeal
5. Platform Fit
6. Engagement Potential

​

8. taxonomy_mapping

​

9. fan_profiles

​

10. action_flows

• scout-analyze: Scrape URL + AI analysis
• taxonomy-tag: Auto-classify content
• post-create: Draft platform-specific post
• message-generate: Fan engagement message
• memory-recall: Search stored data + summarize
• media-process: Queue media job (watermark, teaser, compress)

​

11. agent_audits

​

Directus Flows

• Webhooks: External HTTP POST triggers
• Schedule: Cron-based triggers
• Events: Collection CRUD events (insert, update, delete)
• Manual: Triggered via trigger-flow MCP tool or API

​

Example Flow: Platform Scraping

1. stagehand_cookie_login: Inject cookies from platform_sessions + navigate to creator profile
2. stagehand_extract: Extract profile stats (followers, earnings, recent posts)
3. create-item (Directus): Insert/update scraped_media records
4. stagehand_close: End browser session

​

Creating Custom Flows

1. Navigate to https://geniehelper.com/admin → Flows
2. Click “Create Flow”
3. Select trigger type
4. Add operations:
   • Webhook / HTTP Request: Call external APIs
   • Run Script: Execute Node.js code
   • Condition: Branching logic
   • Create/Update/Delete Data: Directus CRUD
   • Send Notification: Email, push, webhook
   • Trigger Another Flow: Flow chaining

​

Authentication & RBAC

​

User Roles

​

RBAC Sync

1. User registers in dashboard /register
2. Dashboard calls /api/register (proxy to Directus /users with admin token)
3. Directus creates user + triggers RBAC sync webhook
4. Sync webhook creates user_personas collection record
5. User can now log in and access dashboard

• /home/daytona/workspace/source/server/endpoints/api/register.js:1
• /home/daytona/workspace/source/server/endpoints/api/rbacSync.js:1

​

JWT Tokens

• Access Token: Short-lived (15 min), used for API requests
• Refresh Token: Long-lived (7 days), used to renew access token

• Access token: localStorage.getItem('directus_token')
• Refresh token: Auto-refreshed via Directus SDK

​

API Proxy

location /api/directus/ {
    proxy_pass http://127.0.0.1:8055/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

// dashboard/src/utils/api.js
import axios from 'axios';

const directusApi = axios.create({
  baseURL: '/api/directus',
  headers: {
    Authorization: `Bearer ${localStorage.getItem('directus_token')}`
  }
});

export const getScheduledPosts = () => 
  directusApi.get('/items/scheduled_posts?filter[status][_eq]=pending');

​

Environment Variables

​

Debugging

​

Check Directus Logs

pm2 logs agentx-cms --lines 50

​

Restart Directus

pm2 restart agentx-cms

​

Query Collections via CLI

curl -H "Authorization: Bearer $DIRECTUS_ADMIN_TOKEN" \
  https://geniehelper.com/api/directus/items/media_jobs?limit=5

​

Access Admin Panel

• Email: admin@geniehelper.com
• Password: (see README admin credentials section)

• Browse collections
• Edit records
• View flows
• Monitor activity logs
• Manage users and roles

​

Performance Tips

​

Enable Caching

CACHE_ENABLED=true
CACHE_STORE=redis
REDIS=redis://localhost:6379

​

Optimize Queries

// ❌ Bad: Fetches all fields + relationships
api.get('/items/scraped_media');

// ✅ Good: Only fetch needed fields
api.get('/items/scraped_media?fields=id,caption,likes,published_at');

​

Indexed Fields

• creator_profiles.user_id
• scraped_media.creator_profile_id
• scheduled_posts.scheduled_for
• media_jobs.status
• platform_sessions.platform

​

Related Documentation

• Browser Extension - Cookie capture for platform authentication
• Stagehand Automation - Browser automation workflows
• Platform Connections - Managing creator credentials