Need help with CodeTeleport?

Most questions are answered in the docs. If not, we're here.

Documentation

Full guides for CLI, MCP tools, and concepts.

Community Discord

Ask questions, share feedback, get help.

Report a Bug

Found something broken? Post in #bugs on Discord.

Feature Requests

Have an idea? Start a GitHub discussion.

Common issues

"Not authenticated" error

You need to log in first. Run codeteleport auth login and complete the GitHub OAuth or email/password flow. Your token is saved to ~/.codeteleport/config.json.

"Session not found" when pulling

The session ID doesn't exist in your cloud account, or it was deleted. Run codeteleport list --cloud to see what's available. Make sure you're logged into the same account on both machines.

Paths look wrong after pulling

CodeTeleport rewrites paths based on your current working directory when you pull. Make sure you cd into your project directory before running codeteleport pull. The session will be anchored to whatever directory you're in.

Hit the session or device limit

Free accounts get 25 sessions and 3 devices. Check your usage with codeteleport status. Upgrade to Pro ($5/quarter) for unlimited sessions and devices, or delete old sessions to free up space.

Push isn't detecting my session

CodeTeleport scans ~/.claude/projects/ for sessions tied to your current directory. Make sure you're in the project directory where you ran your coding agent, and that the session files exist. Run codeteleport list --local to see what's detected.

Still stuck?

Ask in our Discord — fastest way to get help. Or email support@codeteleport.com — we typically respond within 24 hours.

For bugs, please include: your OS, Node.js version, codeteleport version (codeteleport --version), and the full error message.