Frequently Asked Questions
Find answers to common questions about using AgentsMesh.
Runner Issues
My Runner shows as 'Offline'. How do I fix it?
Check the following: 1) Ensure the Runner process is actually running (agentsmesh-runner run). 2) Verify network connectivity to the AgentsMesh server. 3) Ensure firewalls allow outbound gRPC connections on port 9443. 4) Check Runner logs for certificate errors — you may need to re-register if the certificate has expired.
Can I run multiple Runners on the same machine?
Yes, but each Runner needs its own registration token and configuration directory. Use the --config flag to specify different config paths. Each Runner can handle multiple Pods concurrently.
Pod Issues
Pod creation fails with 'No available runners'. What should I do?
This means no Runner is currently online in your organization. Ensure at least one Runner is running and shows as 'Online' in Settings → Runners. If a Runner is running but shows offline, check its network connectivity.
My Pod is stuck in 'Initializing' status. What's happening?
This usually means the repository clone is taking a long time, or the Runner is struggling to create the Git worktree. Check the Runner logs for details. For large repositories, the initial clone may take several minutes.
API Key Configuration
What format should my API keys be in?
Anthropic keys start with 'sk-ant-', OpenAI keys start with 'sk-', and Google keys are typically longer alphanumeric strings. Enter the API key exactly as provided by your AI provider. Keys are encrypted at rest.
Can I use different API keys for different Pods?
Currently, API keys are configured at the organization level. All Pods in the organization share the same API keys. This may change in future releases.
Git Integration
Git clone fails when creating a Pod. What should I check?
Verify: 1) The Git provider is connected in Settings → Personal → Git Settings. 2) The repository URL is correct. 3) For SSH access, ensure the Runner machine has the correct SSH keys. 4) For HTTPS, ensure the token has repository read access.
Can multiple Pods work on the same repository simultaneously?
Yes! Each Pod gets its own Git worktree, so multiple Pods can work on the same repository without conflicts. Each worktree operates on its own branch, and changes are isolated.
Billing & Plans
How does the BYOK (Bring Your Own Key) billing model work?
You provide your own API keys for AI providers (Anthropic, OpenAI, Google, etc.). You pay the AI providers directly based on your usage. AgentsMesh charges only for platform usage (runners, storage, etc.).
Is there a free tier?
Yes, AgentsMesh offers a free tier with limited concurrent Pods and storage. Check the Pricing page for current plan details and limits.