Frequently Asked Questions

How do I install RelayPlane?

Install globally via npm:

1npm install -g @relayplane/proxy

Then start the proxy with relayplane-proxy.

What environment variables do I need?

Set the API keys for the providers you use:

1export ANTHROPIC_API_KEY=sk-ant-...
2export OPENAI_API_KEY=sk-...
3export GEMINI_API_KEY=...

How do I connect my AI tools to RelayPlane?

Point your tools to the proxy URL. The proxy runs at http://localhost:3001 by default:

1# For Anthropic tools
2export ANTHROPIC_BASE_URL=http://localhost:3001
3
4# For OpenAI tools
5export OPENAI_BASE_URL=http://localhost:3001

Can I use RelayPlane with Claude Code / Cursor / Aider?

Yes! Any tool that uses the Anthropic or OpenAI API can be routed through RelayPlane. Just set the appropriate *_BASE_URL environment variable before starting your tool.

Does RelayPlane see my prompts?

No. The proxy runs locally on your machine. Your prompts and responses go directly to the AI providers. RelayPlane only sees metadata (token counts, model used, latency) — never the content of your messages.

What telemetry is collected?

Only anonymous metadata to improve routing:

• Anonymous device ID (random, not fingerprintable)
• Task type (inferred from token patterns, not content)
• Model used, token counts, latency, cost

Use relayplane-proxy --audit to see exactly what's collected before sending.

How do I disable telemetry?

1# Disable telemetry completely
2relayplane-proxy telemetry off
3
4# Or run in offline mode (no network calls except to LLM providers)
5relayplane-proxy --offline

Is my data stored anywhere?

Usage data is stored locally in ~/.relayplane/. If telemetry is enabled, anonymous aggregated stats are sent to improve routing. Your prompts and responses are never stored or transmitted.

Is the free tier really free?

Yes! The free tier includes static model routing and local cost tracking. No credit card required, no time limit. Use it forever.

What do I get with Pro ($29/month)?

Pro adds intelligent routing via the Swarm API:

• ML-powered model selection optimized for your usage patterns
• 30-day history and analytics in the dashboard
• Unlimited Swarm API calls
• Priority support

Most users save $50-150/month — significantly more than the $29 cost.

Can I try Pro before paying?

Yes! Start a 7-day free trial — no credit card required. If you don't upgrade, you automatically revert to the free tier.

How do I cancel my subscription?

Go to Dashboard → Billing → Cancel Subscription. You'll keep Pro features until the end of your billing period, then revert to the free tier.

The proxy isn't starting. What's wrong?

Check these common issues:

• Port 3001 may be in use. Try relayplane-proxy --port 3002
• Ensure Node.js 18+ is installed
• Check that API keys are set in your environment

My requests are failing with 401 errors

This means the proxy is running but your API key is invalid or not set. Check that ANTHROPIC_API_KEY orOPENAI_API_KEY is correctly exported in the terminal where the proxy is running.

How do I see my usage statistics?

1# View stats in terminal
2relayplane-proxy stats
3
4# Or visit your dashboard at relayplane.com/dashboard

Where are my config files stored?

All RelayPlane data is stored in ~/.relayplane/:

• config.json — Settings and API key
• telemetry.jsonl — Local telemetry data
• stats.db — Usage statistics

What is "intelligent routing"?

RelayPlane analyzes each request and routes it to the optimal model based on task type, context length, and cost. For example, simple classification tasks might go to a faster, cheaper model, while complex coding tasks go to the most capable model.

How does the Swarm know which model to use?

The Swarm API uses ML models trained on anonymized usage patterns to predict which model will perform best for each task type. It considers factors like token count, input/output ratio, tool usage, and historical success rates.

What models does RelayPlane support?

RelayPlane supports all major AI providers:

• Anthropic: Claude 4, Claude 3.5 Sonnet/Haiku
• OpenAI: GPT-4o, GPT-4 Turbo, GPT-3.5
• Google: Gemini 2.0, Gemini 1.5 Pro/Flash
• xAI: Grok
• Local: Ollama models

Can I override the routing decision?

Yes. The Swarm provides recommendations, but you can configure routing rules to always use specific models for certain task types, or exclude models entirely.