From cohere-pack
Configures Cohere API for dev, staging, prod with per-env models, API keys from AWS/GCP/Vault secrets, tokens, caching, and retries using TypeScript.
npx claudepluginhub jeremylongshore/claude-code-plugins-plus-skills --plugin cohere-packThis skill is limited to using the following tools:
Configure Cohere API v2 across dev/staging/prod with environment-specific API keys, model selection, and budget controls.
Deploys Cohere API v2 apps to Vercel, Fly.io, and Google Cloud Run with secrets management, health checks, and platform configs.
Configures Groq SDK in TypeScript for dev/staging/prod with env-specific models, retries, rate limits, and API keys from secrets or .env files.
Configures Anthropic Claude API for dev, staging, production with isolated keys from Workspaces, per-env models, and spend controls using Python dataclasses and client factory.
Share bugs, ideas, or general feedback.
Configure Cohere API v2 across dev/staging/prod with environment-specific API keys, model selection, and budget controls.
| Environment | API Key Type | Model | maxTokens | Caching |
|---|---|---|---|---|
| Development | Trial (free) | command-r7b-12-2024 | 200 | Disabled |
| Staging | Production | command-r-08-2024 | 1000 | Enabled |
| Production | Production | command-a-03-2025 | 4096 | Enabled |
// src/config/cohere.ts
type Environment = 'development' | 'staging' | 'production';
interface CohereEnvConfig {
chatModel: string;
embedModel: string;
rerankModel: string;
maxTokens: number;
cacheEnabled: boolean;
cacheTtlMs: number;
retries: number;
timeoutSeconds: number;
}
const configs: Record<Environment, CohereEnvConfig> = {
development: {
chatModel: 'command-r7b-12-2024', // Fastest, cheapest
embedModel: 'embed-v4.0',
rerankModel: 'rerank-v3.5',
maxTokens: 200, // Limit for dev
cacheEnabled: false, // See real responses
cacheTtlMs: 0,
retries: 1, // Fail fast in dev
timeoutSeconds: 30,
},
staging: {
chatModel: 'command-r-08-2024', // Mid-tier for testing
embedModel: 'embed-v4.0',
rerankModel: 'rerank-v3.5',
maxTokens: 1000,
cacheEnabled: true,
cacheTtlMs: 5 * 60 * 1000, // 5 minutes
retries: 3,
timeoutSeconds: 60,
},
production: {
chatModel: 'command-a-03-2025', // Best quality
embedModel: 'embed-v4.0',
rerankModel: 'rerank-v3.5',
maxTokens: 4096,
cacheEnabled: true,
cacheTtlMs: 15 * 60 * 1000, // 15 minutes
retries: 5,
timeoutSeconds: 120,
},
};
function detectEnvironment(): Environment {
const env = process.env.NODE_ENV ?? 'development';
if (['development', 'staging', 'production'].includes(env)) {
return env as Environment;
}
return 'development';
}
export function getCohereConfig(): CohereEnvConfig & { environment: Environment } {
const env = detectEnvironment();
return { ...configs[env], environment: env };
}
// src/cohere/client.ts
import { CohereClientV2 } from 'cohere-ai';
import { getCohereConfig } from '../config/cohere';
let instance: CohereClientV2 | null = null;
export function getCohere(): CohereClientV2 {
if (!instance) {
const config = getCohereConfig();
if (!process.env.CO_API_KEY) {
throw new Error(`CO_API_KEY not set for ${config.environment} environment`);
}
instance = new CohereClientV2({
token: process.env.CO_API_KEY,
timeoutInSeconds: config.timeoutSeconds,
});
console.log(`[cohere] Initialized for ${config.environment} (model: ${config.chatModel})`);
}
return instance;
}
# --- Local Development ---
# .env.local (git-ignored)
CO_API_KEY=trial-key-for-dev
# --- GitHub Actions (CI) ---
gh secret set CO_API_KEY --body "production-key-for-ci"
# --- AWS Secrets Manager ---
aws secretsmanager create-secret \
--name cohere/staging/api-key \
--secret-string "staging-production-key"
aws secretsmanager create-secret \
--name cohere/production/api-key \
--secret-string "prod-production-key"
# --- GCP Secret Manager ---
echo -n "staging-key" | gcloud secrets create cohere-api-key-staging --data-file=-
echo -n "prod-key" | gcloud secrets create cohere-api-key-prod --data-file=-
# --- HashiCorp Vault ---
vault kv put secret/cohere/staging api_key="staging-key"
vault kv put secret/cohere/production api_key="prod-key"
// Prevent expensive operations in development
function guardExpensiveOperation(operation: string): void {
const config = getCohereConfig();
if (config.environment === 'development') {
// In dev, warn but don't block
console.warn(`[cohere] ${operation} using trial key — limited to 20 calls/min`);
}
}
// Prevent development keys in production
function validateKeyForEnv(): void {
const config = getCohereConfig();
const key = process.env.CO_API_KEY ?? '';
if (config.environment === 'production' && key.length < 30) {
throw new Error('Production requires a production API key (not trial)');
}
}
import { getCohereConfig } from '../config/cohere';
export async function chat(message: string): Promise<string> {
const config = getCohereConfig();
const cohere = getCohere();
const response = await cohere.chat({
model: config.chatModel, // Environment-specific model
messages: [{ role: 'user', content: message }],
maxTokens: config.maxTokens, // Environment-specific limit
});
return response.message?.content?.[0]?.text ?? '';
}
export async function embed(texts: string[]): Promise<number[][]> {
const config = getCohereConfig();
const cohere = getCohere();
const response = await cohere.embed({
model: config.embedModel,
texts,
inputType: 'search_document',
embeddingTypes: config.environment === 'development' ? ['float'] : ['int8'], // Cheaper in prod
});
return response.embeddings.float ?? response.embeddings.int8;
}
# docker-compose.yml
services:
app-dev:
build: .
environment:
- NODE_ENV=development
- CO_API_KEY=${CO_API_KEY_DEV}
ports:
- "3000:3000"
app-staging:
build: .
environment:
- NODE_ENV=staging
- CO_API_KEY=${CO_API_KEY_STAGING}
ports:
- "3001:3000"
| Issue | Cause | Solution |
|---|---|---|
| Trial key in production | Wrong secret | Validate key length at startup |
| Rate limited in dev | Trial key limits | Use 20 calls/min budget |
| Model not found | Typo in config | Validate model IDs at startup |
| Config merge fails | Missing environment | Default to development |
For observability setup, see cohere-observability.