Skip to main content

CODITECT Pilot - FAQ

Version: 1.0.0 Target Audience: Pilot participants Last Updated: January 7, 2026

Table of Contents​

  1. Account & Login
  2. Cloud Workstations
  3. Licenses & Billing
  4. Container Sessions
  5. Team & Organization
  6. Local Docker
  7. Claude Code & CODITECT
  8. Pilot Program

Account & Login​

Q: I can't log in. What should I do?​

A: Try these steps in order:

  1. Verify email: Check you're using the correct email
  2. Reset password: Click "Forgot Password" on the login page
  3. Check 2FA: If enabled, ensure you have your authenticator app ready
  4. Clear cookies: Clear browser cookies and try again
  5. Try incognito: Use a private/incognito browser window
  6. Contact support: Email support@coditect.ai if still stuck

Q: I forgot my 2FA device. How do I recover my account?​

A: If you saved your backup codes during 2FA setup:

  1. Click "Use backup code" on the 2FA screen
  2. Enter one of your backup codes
  3. Disable 2FA in Security settings
  4. Re-enable with new device

If you don't have backup codes, contact support@coditect.ai for identity verification.

Q: How do I change my email address?​

A: Email changes require support assistance for security reasons:

  1. Email support@coditect.ai from your current email
  2. Request email change to new address
  3. We'll verify your identity and process the change

Q: Can I have multiple accounts?​

A: No. Each person should have one account. For team access, use the Team Management feature in your organization.

Cloud Workstations​

Q: My workstation is stuck in "Creating" state. What do I do?​

A: Workstation creation typically takes 1-2 minutes. If stuck longer:

  1. Wait 5 minutes: Initial creation can take longer
  2. Refresh the page: Sometimes the status doesn't auto-update
  3. Check your license: Ensure your license is active
  4. Contact support: If still creating after 10 minutes

Q: My workstation won't start. It shows an error.​

A: Common causes and solutions:

ErrorCauseSolution
"License expired"License not activeRenew subscription
"Session limit reached"Too many active sessionsTerminate other sessions
"Resource unavailable"Temporary cloud issueWait 5 minutes, retry
"Configuration error"Workstation config issueContact support

Q: How do I keep my files when the workstation stops?​

A: Your files are automatically persisted. The home directory (~/) is stored on persistent disk. However:

  • DO save work regularly: Git commit + push important changes
  • DON'T store in /tmp: Temporary files are not persisted
  • DON'T exceed disk quota: Files may not save if disk is full

Q: Why is my workstation slow?​

A: Possible causes:

  1. Network latency: Check your internet connection
  2. Heavy workload: Running builds, ML training, etc.
  3. Configuration: Consider upgrading to Power or AI tier
  4. Browser: Try Chrome for best performance

Q: Can I use my own VS Code extensions?​

A: Yes! The workstation uses Code OSS (VS Code compatible). Install extensions normally via the Extensions panel. They persist across sessions.

Licenses & Billing​

Q: Where do I find my license key?​

A:

  1. Log in to auth.coditect.ai
  2. Go to Dashboard or Profile → License
  3. Your license key is displayed (click to copy)

Q: My license shows "Expired" but I just paid. Why?​

A: Payment processing can take a few minutes. Try:

  1. Refresh the page after 5 minutes
  2. Check email for payment confirmation
  3. View Billing → Invoices to verify payment status
  4. Contact support if not resolved within 1 hour

Q: How do I get an invoice for my purchase?​

A:

  1. Go to Billing → Invoices
  2. Find the invoice you need
  3. Click "Download PDF"

All invoices are also emailed to your account email.

Q: Can I get a refund?​

A: We offer refunds within 14 days of purchase if you haven't used the service extensively. Contact support@coditect.ai with your order details.

Q: Do workstations cost extra when running?​

A: Workstation compute is included in your subscription. There are no additional charges for running your workstation. However, stopped workstations don't consume compute resources.

Container Sessions​

Q: I'm getting "Session limit reached" error. What does this mean?​

A: Your license has a maximum concurrent session limit:

  • Pro: 3 concurrent sessions
  • Enterprise: 10+ concurrent sessions

To fix:

  1. Go to Container Sessions in your dashboard
  2. Terminate sessions you're no longer using
  3. Try again

Q: What's the difference between a session and a workstation?​

A:

ConceptDescription
WorkstationYour persistent cloud development environment
SessionA single active connection/instance using your license

One workstation can have multiple sessions (e.g., multiple terminal windows), and you can also have local Docker sessions that count against your limit.

Q: Sessions show as "expired" but I didn't stop them. Why?​

A: Sessions expire automatically after:

  • 24 hours of inactivity
  • Workstation stopped (sessions end with workstation)
  • License expired (all sessions terminated)

This is normal behavior to free up resources.

Team & Organization​

Q: How do I add team members?​

A: (Enterprise plans only)

  1. Go to Dashboard → Team
  2. Click "Invite Member"
  3. Enter their email
  4. Select their role (Member or Admin)
  5. Click "Send Invitation"

Q: My team member didn't receive the invitation email.​

A: Ask them to:

  1. Check spam/junk folder
  2. Search for "coditect" in all mail folders
  3. Verify the email address is correct

You can also resend the invitation from Team → Pending Invitations.

Q: How do license seats work for teams?​

A:

  • Seat = 1 user: Each team member needs one seat
  • Purchased seats: Your plan's seat count (e.g., 10 seats)
  • Assigned seats: Seats given to team members
  • Available seats: Purchased - Assigned

To add more users than your seat count, upgrade your plan.

Q: Can team members see each other's workstations?​

A: No. Workstations are private to each user. Admins can see session counts but not access other users' environments.

Local Docker​

Q: How do I run CODITECT locally with Docker?​

A:

  1. Download your license.json from the dashboard
  2. Run the container:
docker run -it \
  -v $(pwd)/license.json:/opt/coditect/license.json:ro \
  -v $(pwd)/projects:/home/developer/projects \
  us-central1-docker.pkg.dev/coditect-cloud-infra/coditect-images/coditect-core:latest

See DOCKER-DEPLOYMENT-GUIDE.md for full documentation.

Q: I get "unauthorized" when pulling the Docker image.​

A: You need to authenticate with the registry:

  1. Go to Dashboard → Docker Access
  2. Click "Generate Docker Token"
  3. Run the provided docker login command
  4. Try pulling again

Q: Can I use both cloud and local Docker?​

A: Yes! Your license works for both. Just remember:

  • Both count toward your session limit
  • Cloud workstation + 2 local Docker = 3 sessions

Claude Code & CODITECT​

Q: What Claude Code commands are available?​

A: Key commands:

CommandDescription
/helpShow all commands
/orientSession orientation
/which <task>Find the right agent
/agent <name> "task"Invoke specific agent
/cxCapture session context
/cxq "search"Query saved context

Q: How do I find the right agent for my task?​

A: Use the /which command:

/which "deploy to kubernetes"
/which "write API documentation"
/which "review code for security"

It returns the best-matched agent with usage instructions.

Q: My Claude Code session isn't responding.​

A: Try these fixes:

  1. Wait 30 seconds: AI responses can take time
  2. Check network: Ensure internet connectivity
  3. Restart Claude: Exit and restart claude command
  4. Restart terminal: Close and reopen terminal
  5. Check status: Visit status.anthropic.com for outages

Pilot Program​

Q: How long does the pilot program last?​

A: The pilot program runs until public launch (March 2026). Pilot participants get:

  • Early access to features
  • Direct feedback channel
  • Priority support
  • Pilot pricing (locked in for 1 year)

Q: Will my data be preserved after the pilot?​

A: Yes. Your account, workstation, and files continue seamlessly into general availability.

Q: How do I report bugs or request features?​

A:

Q: Is there a pilot community or Discord?​

A: Yes! Find the Discord link in your dashboard under Community. Connect with other pilot testers and the CODITECT team.

Still Need Help?​

If your question isn't answered here:

  1. Search docs: docs.coditect.ai
  2. GitHub Issues: github.com/coditect-ai/coditect-core/issues
  3. Email support: support@coditect.ai
  4. Discord: Link in dashboard

We typically respond within 24 hours for pilot participants.

CODITECT Pilot Program - AZ1.AI INC