tasq/node_modules/agentic-flow/.claude/commands/flow-nexus/user-tools.md

name	description
flow-nexus-user-tools	User management, storage, and system utilities

Flow Nexus User Tools

Utilities for user management, storage, and system operations.

Profile Management

// Get profile
mcp__flow-nexus__user_profile({
  user_id: "your_id"
})

// Update profile
mcp__flow-nexus__user_update_profile({
  user_id: "your_id",
  updates: {
    full_name: "New Name",
    bio: "Developer interested in AI",
    github_username: "username"
  }
})

// Get statistics
mcp__flow-nexus__user_stats({
  user_id: "your_id"
})

Storage Management

// Upload file
mcp__flow-nexus__storage_upload({
  bucket: "my-bucket",
  path: "data/file.json",
  content: JSON.stringify(data),
  content_type: "application/json"
})

// List files
mcp__flow-nexus__storage_list({
  bucket: "my-bucket",
  path: "data/",
  limit: 100
})

// Get public URL
mcp__flow-nexus__storage_get_url({
  bucket: "my-bucket",
  path: "data/file.json",
  expires_in: 3600 // seconds
})

// Delete file
mcp__flow-nexus__storage_delete({
  bucket: "my-bucket",
  path: "data/file.json"
})

Real-time Subscriptions

// Subscribe to database changes
mcp__flow-nexus__realtime_subscribe({
  table: "tasks",
  event: "INSERT", // UPDATE, DELETE, *
  filter: "status=eq.pending"
})

// List subscriptions
mcp__flow-nexus__realtime_list()

// Unsubscribe
mcp__flow-nexus__realtime_unsubscribe({
  subscription_id: "sub_id"
})

Execution Monitoring

// Monitor execution stream
mcp__flow-nexus__execution_stream_subscribe({
  stream_type: "claude-flow-swarm",
  deployment_id: "deployment_id"
})

// Get stream status
mcp__flow-nexus__execution_stream_status({
  stream_id: "stream_id"
})

// List generated files
mcp__flow-nexus__execution_files_list({
  stream_id: "stream_id",
  created_by: "claude-flow",
  file_type: "javascript"
})

// Get file content
mcp__flow-nexus__execution_file_get({
  file_id: "file_id"
})

System Health

// Check system health
mcp__flow-nexus__system_health()

// View audit logs
mcp__flow-nexus__audit_log({
  user_id: "your_id",
  limit: 100
})

Queen Seraphina Chat

// Seek guidance from Queen Seraphina
mcp__flow-nexus__seraphina_chat({
  message: "How should I architect my distributed system?",
  enable_tools: true, // Allow her to create swarms/deploy code
  conversation_history: [
    { role: "user", content: "Previous message" },
    { role: "assistant", content: "Previous response" }
  ]
})

Email Verification

mcp__flow-nexus__user_verify_email({
  token: "verification_token_from_email"
})

Storage Buckets

• public: Publicly accessible files
• private: User-only access
• shared: Team collaboration
• temp: Auto-deleted after 24h

Best Practices

1. Use appropriate storage buckets
2. Set expiration on temporary URLs
3. Monitor real-time subscriptions
4. Clean up unused subscriptions
5. Regular audit log reviews
6. Enable 2FA for security (coming soon)