Skip to main content Home Skills Automation & Agents twinmind-upgrade-migration twinmind-upgrade-migration jeremylongshore
Upgrade between TwinMind plan tiers and migrate configurations.
Use when upgrading from Free to Pro, Pro to Enterprise,
or migrating between TwinMind environments.
Trigger with phrases like "upgrade twinmind", "twinmind pro",
"twinmind enterprise", "migrate twinmind", "twinmind tier change".
bunx add-skill jeremylongshore/claude-code-plugins-plus-skills -s twinmind-upgrade-migration ai automation claude-code devops marketplace mcp
TwinMind Upgrade & Migration
Overview
Guide for upgrading TwinMind tiers and migrating configurations between environments.
Prerequisites
Active TwinMind account
Admin access for billing changes
Backup of current configurations
Plan Comparison
Feature Free Pro ($10/mo) Enterprise (Custom) Transcription Unlimited Unlimited Unlimited Languages 140+ 140+ (Premium Ear-3) 140+ (Premium) AI Models Basic GPT-4, Claude, Gemini Custom + Fine-tuned Context Tokens 500K 2M Unlimited API Access No Yes Yes + Priority Rate Limits 30/min 60/min 300/min Concurrent Jobs
Support Community 24-hour Dedicated
Instructions
Step 1: Audit Current Usage // scripts/usage-audit.ts
import { getTwinMindClient } from '../src/twinmind/client';
async function auditUsage() {
const client = getTwinMindClient();
// Get current plan info
const account = await client.get('/account');
console.log('Current Plan:', account.data.plan);
console.log('Plan Started:', account.data.plan_started_at);
// Get usage statistics
const usage = await client.get('/usage', {
params: {
period: 'last_30_days',
},
});
console.log('\n=== Usage Summary (Last 30 Days) ===');
console.log(`Transcription Hours: ${usage.data.transcription_hours}`);
console.log(`API Requests: ${usage.data.api_requests}`);
console.log(`AI Tokens Used: ${usage.data.ai_tokens_used}`);
console.log(`Storage Used: ${usage.data.storage_mb} MB`);
// Check if hitting limits
const limits = await client.get('/account/limits');
console.log('\n=== Current Limits ===');
console.log(`Rate Limit: ${limits.data.rate_limit_per_minute}/min`);
console.log(`Concurrent Jobs: ${limits.data.concurrent_transcriptions}`);
console.log(`Context Tokens: ${limits.data.context_tokens}`);
// Recommendations
console.log('\n=== Upgrade Recommendations ===');
if (usage.data.api_requests > 0 && account.data.plan === 'free') {
console.log('- Upgrade to Pro for API access');
}
if (usage.data.ai_tokens_used > 400000) {
console.log('- Consider Pro for 2M token context');
}
if (usage.data.rate_limit_hits > 10) {
console.log('- Upgrade tier for higher rate limits');
}
}
auditUsage();
Step 2: Export Current Configuration // scripts/export-config.ts
import * as fs from 'fs';
interface TwinMindConfig {
version: string;
exportedAt: string;
settings: {
language: string;
diarization: boolean;
model: string;
privacy: {
redactPII: boolean;
retentionDays: number;
};
};
integrations: Array<{
type: string;
enabled: boolean;
config: Record<string, any>;
}>;
webhooks: Array<{
url: string;
events: string[];
active: boolean;
}>;
}
async function exportConfiguration(): Promise<TwinMindConfig> {
const client = getTwinMindClient();
// Fetch all configuration
const [settings, integrations, webhooks] = await Promise.all([
client.get('/settings'),
client.get('/integrations'),
client.get('/webhooks'),
]);
const config: TwinMindConfig = {
version: '1.0',
exportedAt: new Date().toISOString(),
settings: {
language: settings.data.default_language,
diarization: settings.data.diarization_enabled,
model: settings.data.transcription_model,
privacy: {
redactPII: settings.data.redact_pii,
retentionDays: settings.data.retention_days,
},
},
integrations: integrations.data.map((i: any) => ({
type: i.type,
enabled: i.enabled,
config: i.config,
})),
webhooks: webhooks.data.map((w: any) => ({
url: w.url,
events: w.events,
active: w.active,
})),
};
// Save to file
const filename = `twinmind-config-${Date.now()}.json`;
fs.writeFileSync(filename, JSON.stringify(config, null, 2));
console.log(`Configuration exported to: ${filename}`);
return config;
}
exportConfiguration();
Step 3: Upgrade Plan
Via Dashboard
Via API (Enterprise Only) // Upgrade request for Enterprise
async function requestEnterpriseUpgrade() {
const client = getTwinMindClient();
const response = await client.post('/account/upgrade-request', {
target_plan: 'enterprise',
contact_email: 'admin@company.com',
company_name: 'Acme Inc',
estimated_usage: {
transcription_hours_monthly: 1000,
api_requests_monthly: 100000,
team_members: 50,
},
requirements: [
'SSO/SAML integration',
'On-premise deployment',
'Custom model training',
'99.9% SLA',
],
});
console.log('Upgrade request submitted:', response.data.request_id);
console.log('Sales team will contact you within 24 hours');
}
Step 4: Update API Keys # After upgrade, generate new production API key
# Go to: https://twinmind.com/settings/api
# Update environment variables
export TWINMIND_API_KEY="tm_sk_prod_new_key_here"
# Update secrets manager (recommended for production)
aws secretsmanager update-secret \
--secret-id twinmind-api-key \
--secret-string "$TWINMIND_API_KEY"
# Verify new key works
curl -H "Authorization: Bearer $TWINMIND_API_KEY" \
https://api.twinmind.com/v1/me
Step 5: Import Configuration to New Tier // scripts/import-config.ts
import * as fs from 'fs';
async function importConfiguration(configFile: string) {
const client = getTwinMindClient();
const config = JSON.parse(fs.readFileSync(configFile, 'utf-8'));
console.log(`Importing configuration from: ${configFile}`);
console.log(`Exported at: ${config.exportedAt}`);
// Import settings
console.log('\nImporting settings...');
await client.patch('/settings', {
default_language: config.settings.language,
diarization_enabled: config.settings.diarization,
transcription_model: config.settings.model,
redact_pii: config.settings.privacy.redactPII,
retention_days: config.settings.privacy.retentionDays,
});
console.log('Settings imported successfully');
// Import integrations
console.log('\nImporting integrations...');
for (const integration of config.integrations) {
if (integration.enabled) {
await client.post('/integrations', integration);
console.log(` - ${integration.type}: enabled`);
}
}
// Import webhooks
console.log('\nImporting webhooks...');
for (const webhook of config.webhooks) {
if (webhook.active) {
await client.post('/webhooks', webhook);
console.log(` - ${webhook.url}: configured`);
}
}
console.log('\nConfiguration import complete!');
}
// Usage: npx ts-node scripts/import-config.ts twinmind-config-123456.json
const configFile = process.argv[2];
if (configFile) {
importConfiguration(configFile);
} else {
console.error('Usage: ts-node import-config.ts <config-file.json>');
}
Step 6: Verify Upgraded Features // scripts/verify-upgrade.ts
async function verifyUpgrade() {
const client = getTwinMindClient();
const account = await client.get('/account');
const plan = account.data.plan;
console.log(`Current Plan: ${plan}`);
console.log('\nVerifying features...\n');
// Test API access (Pro+)
if (plan === 'pro' || plan === 'enterprise') {
try {
const health = await client.get('/health');
console.log('[PASS] API Access');
} catch {
console.log('[FAIL] API Access');
}
}
// Test rate limits
const limits = await client.get('/account/limits');
console.log(`[INFO] Rate Limit: ${limits.data.rate_limit_per_minute}/min`);
// Test premium models (Pro+)
if (plan === 'pro' || plan === 'enterprise') {
try {
const models = await client.get('/models');
const hasEar3 = models.data.some((m: any) => m.id === 'ear-3');
console.log(hasEar3 ? '[PASS] Ear-3 Model Access' : '[FAIL] Ear-3 Model');
} catch {
console.log('[FAIL] Model Access');
}
}
// Test context tokens
console.log(`[INFO] Context Tokens: ${limits.data.context_tokens}`);
// Enterprise-specific checks
if (plan === 'enterprise') {
// SSO check
const sso = await client.get('/settings/sso');
console.log(sso.data.enabled ? '[PASS] SSO Enabled' : '[INFO] SSO Available');
// SLA check
console.log('[INFO] SLA: 99.9% uptime guaranteed');
}
console.log('\nUpgrade verification complete!');
}
verifyUpgrade();
Step 7: Update Application Configuration // src/config/twinmind.ts
// Tier-specific configuration
const tierConfigs = {
free: {
rateLimit: 30,
concurrent: 1,
contextTokens: 500000,
model: 'ear-2',
},
pro: {
rateLimit: 60,
concurrent: 3,
contextTokens: 2000000,
model: 'ear-3',
},
enterprise: {
rateLimit: 300,
concurrent: 10,
contextTokens: Infinity,
model: 'ear-3-custom',
},
};
export function getConfigForTier(tier: 'free' | 'pro' | 'enterprise') {
return tierConfigs[tier];
}
// Update queue configuration after upgrade
export function updateQueueForTier(tier: 'free' | 'pro' | 'enterprise') {
const config = getConfigForTier(tier);
queue.concurrency = config.concurrent;
queue.intervalCap = config.rateLimit;
console.log(`Queue updated for ${tier} tier:`, config);
}
Migration Paths
Free to Pro
Enable billing in dashboard
Select Pro plan
Generate API key
Update environment variables
Enable premium features
Pro to Enterprise
Contact sales or submit upgrade request
Complete enterprise onboarding
Configure SSO/SAML if needed
Set up dedicated support channel
Review custom SLA terms
Environment Migration (Dev to Prod)
Export dev configuration
Create production API key
Set up production secrets
Import configuration
Verify all features
Output
Usage audit report
Exported configuration backup
Upgraded plan verification
Updated application configuration
Error Handling Issue Cause Solution Payment failed Invalid card Update payment method Config import failed Version mismatch Manually update settings Features not available Plan not activated Wait 5 mins, refresh Rate limit unchanged Cache stale Clear cache, re-auth
Resources
Next Steps For CI/CD integration, see twinmind-ci-integration.