cleveragents-core/docs/reference/cloud/cloud_features.md

Cloud-Only Features Analysis

Features that need removal or replacement for self-hosted CleverAgents.

Summary

• Total cloud features identified: 15
• Features to remove: 6
• Features to replace: 9
• Go files affected: 35

Replacement Strategies

Features to Remove

These features should be completely removed:

• billing_ui (high priority)

  • Web-based billing and subscription UI
  • Notes: Replace with self-host cost estimation guide

• api_proxy (high priority)

  • Cloud API key proxying service
  • Notes: Users manage their own provider API keys

• old_api_versions (medium priority)

  • Backward compatibility with old API versions
  • Notes: CleverAgents starts fresh with v1 only

• cloud_backups (low priority)

  • Automated cloud backups
  • Notes: Provide backup scripts and best practices

• push_notifications (low priority)

  • Mobile/desktop push notifications
  • Notes: Focus on CLI/TUI notifications

• legacy_models (low priority)

  • Support for deprecated model versions
  • Notes: Remove support for EOL models

Features to Replace

These features need local alternatives:

• managed_auth (high priority)

  • Cloud-based authentication service
  • Replacement: Local auth with optional LDAP/SAML
  • Notes: Implement local user management with pluggable auth

• email_service (high priority)

  • Cloud email service integration
  • Replacement: SMTP configuration with local mail server
  • Notes: Support standard SMTP with templates

• usage_limits (medium priority)

  • Usage-based limits and quotas
  • Replacement: Configurable local limits
  • Notes: Make limits configurable via settings

• usage_telemetry (medium priority)

  • Usage tracking and analytics
  • Replacement: Opt-in local telemetry with OpenTelemetry
  • Notes: Default to disabled, provide local dashboard option

• api_keys_cloud (medium priority)

  • Cloud-managed API keys
  • Replacement: Local API key management
  • Notes: Store encrypted keys locally

• cdn_assets (medium priority)

  • CDN-hosted static assets
  • Replacement: Bundle assets in distribution
  • Notes: Include all assets in package

• org_management (medium priority)

  • Cloud-based organization management
  • Replacement: Local team management with roles
  • Notes: Simplified local team structure

• error_reporting (low priority)

  • Centralized error reporting service
  • Replacement: Local error logging with optional export
  • Notes: Use structured logging with export options

• team_sync (low priority)

  • Real-time team state synchronization
  • Replacement: Database-based sync for multi-user mode
  • Notes: Use DB polling or websockets locally

Detailed Analysis by Category

Billing

Payment processing and subscription management

Billing Ui

• Action: remove
• Priority: high
• Description: Web-based billing and subscription UI
• Replacement: Documentation on self-hosting costs
• Notes: Replace with self-host cost estimation guide

Usage Limits

• Action: replace
• Priority: medium
• Description: Usage-based limits and quotas
• Functionality:
  • API call limits
  • Storage quotas
  • Team size limits
• Replacement: Configurable local limits
• Notes: Make limits configurable via settings

Telemetry

Usage tracking and analytics

Usage Telemetry

• Action: replace
• Priority: medium
• Description: Usage tracking and analytics
• Replacement: Opt-in local telemetry with OpenTelemetry
• Notes: Default to disabled, provide local dashboard option

Error Reporting

• Action: replace
• Priority: low
• Description: Centralized error reporting service
• Replacement: Local error logging with optional export
• Notes: Use structured logging with export options

Managed Auth

Centralized authentication service

Managed Auth

• Action: replace
• Priority: high
• Description: Cloud-based authentication service
• Functionality:
  • OAuth providers
  • SSO integration
  • Password reset emails
  • Email verification
• Replacement: Local auth with optional LDAP/SAML
• Notes: Implement local user management with pluggable auth

Api Keys Cloud

• Action: replace
• Priority: medium
• Description: Cloud-managed API keys
• Functionality:
  • Key generation
  • Key rotation
  • Usage tracking per key
• Replacement: Local API key management
• Notes: Store encrypted keys locally

Cloud Storage

Cloud-based data storage

Cloud Backups

• Action: remove
• Priority: low
• Description: Automated cloud backups
• Functionality:
  • Automated S3 backups
  • Point-in-time recovery
  • Cross-region replication
• Replacement: Local backup documentation
• Notes: Provide backup scripts and best practices

Cdn Assets

• Action: replace
• Priority: medium
• Description: CDN-hosted static assets
• Replacement: Bundle assets in distribution
• Notes: Include all assets in package

Notifications

Cloud notification services

Email Service

• Action: replace
• Priority: high
• Description: Cloud email service integration
• Functionality:
  • Invite emails
  • Password reset
  • Notifications
  • Reports
• Replacement: SMTP configuration with local mail server
• Notes: Support standard SMTP with templates

Push Notifications

• Action: remove
• Priority: low
• Description: Mobile/desktop push notifications
• Replacement: In-app notifications only
• Notes: Focus on CLI/TUI notifications

Rate Limiting

Cloud-based rate limiting

Team Management

Centralized team/org management

Org Management

• Action: replace
• Priority: medium
• Description: Cloud-based organization management
• Functionality:
  • Org creation
  • Member management
  • Role assignment
  • Billing per org
• Replacement: Local team management with roles
• Notes: Simplified local team structure

Team Sync

• Action: replace
• Priority: low
• Description: Real-time team state synchronization
• Functionality:
  • Real-time updates
  • Presence tracking
  • Shared contexts
• Replacement: Database-based sync for multi-user mode
• Notes: Use DB polling or websockets locally

Api Proxying

API key management and proxying

Api Proxy

• Action: remove
• Priority: high
• Description: Cloud API key proxying service
• Functionality:
  • Hide user API keys
  • Rate limit per user
  • Usage tracking
  • Cost allocation
• Replacement: Direct API usage with user keys
• Notes: Users manage their own provider API keys