FAQ and troubleshooting
Resolutions for sign-in errors, invitation codes, triage behavior, and agent connectivity.
Find solutions to common issues when accessing Mios, inviting teammates, or connecting coding agents.
Sign in issues
Invalid email or password
Double-check your credentials at https://app.mios-ai.com. If your organization enforces single sign-on (SSO), use the SSO provider button instead of standard email and password.
Stale sessions or cookie errors
If you experience unexpected redirect loops, clear browser cookies for mios-ai.com or test sign-in from an incognito window. Ensure your browser allows first-party cookies, which Mios uses to preserve your active session.
Join code not found
Verify code format
Invitation codes are 10-character hexadecimal strings. Verify that you have copied the full code without leading or trailing spaces.
Code expired or rotated
If a manager rotated the organization's invitation code in the Members tab, older codes stop working immediately. Contact your organization manager to get the current code.
Joining a private project
If you are trying to join a private project, an organization-wide invitation code will not grant access. You need the specific project join code, or a project admin must add your account directly.
Seat limit reached
Organizations have a maximum member limit based on their subscription. If an invitation code fails with a limit notice, ask your manager to check seat allocation under organization settings.
Empty triage page
The "To sort" page (/pages/triage) only displays conversations when two conditions are met:
- One or more connected channels are explicitly marked as mixed in Connections (
/pages/connections). - Discussions have occurred in those mixed channels that require manual project assignment.
If no channels are marked as mixed, all connected resources route directly into their assigned projects, leaving the triage queue empty by design.
Agent does not see Mios
If Claude Code or Codex does not show Mios tools or context:
1. Restart your terminal
After running the installer script, environment variables must be reloaded. Close your terminal window completely and open a fresh shell session.
2. Verify the personal token
Verify that MIOS_TOKEN is defined in your environment or within ~/.claude/settings.json. If your token was revoked in your Profile at https://app.mios-ai.com/pages/profile, generate a new token and update your configuration.
3. Check git repository association
Mios agents automatically resolve the current project using the origin remote URL in your git repository. If your local repository remote does not match the URL configured in Mios Connections, create a .mios file at the root of your repository with:
workspace=<project-id>
Replace <project-id> with your numerical project ID, then restart your agent session.