> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codewire.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Frequently asked questions about Codewire

## General

<AccordionGroup>
  <Accordion title="What is Codewire?">
    Codewire provides cloud machines for AI coding agents. Every agent gets its own dedicated, Xen-isolated environment with full root access. Launch Claude Code, Codex, or any tool on isolated machines — and run them in parallel.
  </Accordion>

  <Accordion title="What AI tools work with Codewire?">
    Any tool that runs in a terminal or dev environment: Claude Code, OpenAI Codex, Cursor, GitHub Copilot, Aider, and more. Codewire workspaces are full Linux VMs — if it runs on Linux, it runs on Codewire.
  </Accordion>

  <Accordion title="How does isolation work?">
    Each workspace runs on a Xen hypervisor with its own dedicated kernel. Unlike container-based solutions that share a kernel, Codewire workspaces have full hardware-level isolation. No shared resources, no noisy neighbors.
  </Accordion>

  <Accordion title="How is Codewire different from GitHub Codespaces?">
    Isolation and AI agent support are the main differences. Codespaces uses shared-kernel containers — Codewire uses Xen VMs with dedicated kernels per workspace. Codewire is built for running AI agents in parallel with orchestration primitives (sessions, tags, wait, messaging). Codespaces is designed for single-user interactive development.
  </Accordion>

  <Accordion title="Can I use the CLI without the web dashboard?">
    Yes. The CLI has two operating modes: **Standalone** for local sessions, relay, and orchestration — no Codewire account needed. **Platform mode** integrates with codewire.sh for workspace management, org commands, and remote access.
  </Accordion>

  <Accordion title="Do I need to know Kubernetes to use Codewire?">
    No. Codewire handles all infrastructure — Kubernetes, databases, TLS certificates, and DNS — automatically. You just create a resource and start using it.
  </Accordion>

  <Accordion title="How long does provisioning take?">
    Typically 2-5 minutes for Coder resources. Under a minute for Codewire Relays. You can watch progress in real time on the resource detail page.
  </Accordion>
</AccordionGroup>

## Accounts

<AccordionGroup>
  <Accordion title="How do I get an invite code?">
    Codewire is in private beta. Invite codes are distributed by existing users or the Codewire team. Contact [hello@codewire.sh](mailto:hello@codewire.sh) if you'd like early access.
  </Accordion>

  <Accordion title="I didn't receive my verification email">
    Check your spam/junk folder. You can resend the verification email from the login page. Make sure you entered the correct email during signup.
  </Accordion>

  <Accordion title="I forgot my password">
    Go to the [login page](https://codewire.sh/login), click **Forgot password?**, and enter your email. You'll receive a link to set a new password.
  </Accordion>

  <Accordion title="What happens when I delete my account?">
    Account deletion has a 30-day grace period. During that time you can cancel. After 30 days, all your resources, workspaces, subscriptions, and data are permanently deleted.
  </Accordion>
</AccordionGroup>

## Organizations

<AccordionGroup>
  <Accordion title="How do I create an organization?">
    Navigate to the dashboard and click **New Organization**. Enter a name and slug, then click **Create**.
  </Accordion>

  <Accordion title="Can I belong to multiple organizations?">
    Yes. You can be a member of multiple organizations with different roles in each.
  </Accordion>

  <Accordion title="How many members can I have?">
    There is no limit on organization members. Seat pricing is \$18 per developer per month. AI agents don't count as seats.
  </Accordion>

  <Accordion title="Can I transfer organization ownership?">
    Not self-service currently. Contact [hello@codewire.sh](mailto:hello@codewire.sh) for ownership transfers.
  </Accordion>
</AccordionGroup>

## Resources

<AccordionGroup>
  <Accordion title="Can I change my subdomain after creating a resource?">
    No. The subdomain is permanent. If you need a different subdomain, delete the resource and create a new one.
  </Accordion>

  <Accordion title="What happens when provisioning fails?">
    Check the provision timeline on the resource detail page for error details. In most cases, clicking **Retry Provisioning** resolves the issue. If it continues to fail, contact [hello@codewire.sh](mailto:hello@codewire.sh) with the event details.
  </Accordion>

  <Accordion title="Can I have multiple resources?">
    Yes. You can create as many resources as needed within an organization. Each resource is fully independent with its own infrastructure and settings.
  </Accordion>

  <Accordion title="How do I upgrade Coder?">
    When a new Coder version is available, an **Upgrade** action appears on your resource detail page. Click it to update — your workspaces and data are preserved.
  </Accordion>

  <Accordion title="What is a Codewire Relay?">
    A relay service for AI agent connectivity, provisioned as a resource within your organization. It includes message routing and an authentication token. Connect your CLI nodes to it for remote access and cross-node coordination.
  </Accordion>

  <Accordion title="What is Force Reprovision?">
    A recovery tool that rebuilds the Coder deployment for a stuck resource while preserving all data (workspaces, templates, users, database). Use it when a resource shows Running but the Coder dashboard is inaccessible.
  </Accordion>
</AccordionGroup>

## Billing

<AccordionGroup>
  <Accordion title="What happens when my trial expires?">
    Your resource is suspended (scaled to zero). Add a payment method and subscribe to resume. Your data is preserved.
  </Accordion>

  <Accordion title="How does per-resource billing work?">
    Each resource in your organization has its own subscription and plan. Coder resources have Starter, Pro, Team, and Enterprise plans. Codewire Relays use the Relay plan at \$5/month. All Coder plans include a 14-day free trial.
  </Accordion>

  <Accordion title="How are overages calculated?">
    Usage is tracked in 5-minute intervals and aggregated monthly. Overages are billed at: CPU $0.03/core-hour, Memory $0.01/GB-hour, Disk \$0.05/GB-hour.
  </Accordion>

  <Accordion title="Do AI agents count as seats?">
    No. Seat pricing (\$18/developer/month) is for human developers only. You can run as many AI agents as your resource plan supports.
  </Accordion>
</AccordionGroup>

## Workspaces

<AccordionGroup>
  <Accordion title="Where do I create workspaces?">
    Two ways: use the **Launch** feature in the Codewire sidebar to create a workspace from a repo URL with AI-powered detection, or open your Coder dashboard via the **Open Coder** button and create workspaces from templates.
  </Accordion>

  <Accordion title="What happens to my data when a workspace is stopped?">
    Persistent volumes are preserved when a workspace is stopped. Only compute resources (CPU, memory) are released. Your files remain intact.
  </Accordion>
</AccordionGroup>

## Security

<AccordionGroup>
  <Accordion title="What 2FA methods are supported?">
    Codewire supports TOTP (Time-based One-Time Password) via authenticator apps like Google Authenticator, Authy, or 1Password. 10 backup codes are provided as a fallback. 2FA is mandatory — it's set up during onboarding.
  </Accordion>

  <Accordion title="How do I revoke access from a lost device?">
    Go to [Settings → Sessions](https://codewire.sh/settings/sessions) and revoke the session for that device. You can also click **Revoke All Other Sessions** to sign out everywhere except your current device.
  </Accordion>
</AccordionGroup>

## Support

<AccordionGroup>
  <Accordion title="How do I get help?">
    Email [hello@codewire.sh](mailto:hello@codewire.sh). For billing or account issues, include your organization name and the email associated with your account.
  </Accordion>
</AccordionGroup>