CLI troubleshooting
Stuck on “Connecting…”
Section titled “Stuck on “Connecting…””Quit your AI coding agent fully and open it again to clear the connection state.
“cubedot not recognized” / “command not found”
Section titled ““cubedot not recognized” / “command not found””Open a new terminal window, then run the command again, the global install needs a fresh shell to be on your PATH.
An “Authenticate” / “Needs Auth” button
Section titled “An “Authenticate” / “Needs Auth” button”Don’t click it. CubeDot signs in with your project key automatically; that button is your agent’s generic auth prompt and isn’t needed here.
Verifying everything is healthy
Section titled “Verifying everything is healthy”Run cubedot status (connectivity + file health, read-only) and cubedot check (validates markers/config, CI-friendly). Both are safe to run any time.
Still stuck?
Section titled “Still stuck?”Reach us at cubedot.ai.