For the complete documentation index, see llms.txt. This page is also available as Markdown.
Troubleshooting
The Tessl CLI provides diagnostic capabilities through the tessl doctor command that outputs information about the environment and the CLI itself. This information can be helpful to support and in diagnosing issues. Additionally the CLI will provide guidance on how to resolve issues that are detected. The CLI output defaults to human readable output and can be configured to output JSON for reporting automation.
Usage
tessl doctor [--json]
Flags
--json (boolean, optional): Output diagnostics as JSON for programmatic processing
Examples
Common Issues
Authentication Issues
If you're having trouble authenticating:
Run tessl doctor to check your authentication status
Try logging out and back in: tessl logout then tessl login
Check that your browser allows popups for the authentication flow
Verify your internet connection
Installation Issues
If tessl init or tessl install fails:
Ensure you have the required package manager installed (npm, pip, etc.)
For installing skills from GitHub, tessl install <skill> -v will provide verbose messaging, showing warning details.
Run tessl doctor to identify configuration issues
MCP Server Issues
If your agent cannot connect to the Tessl MCP server:
Verify the MCP server is configured in your agent's settings
Check that tessl mcp start runs without errors
Restart your agent after configuring MCP
Review the MCP configuration in your agent's settings file
Workspace Access Issues
If you cannot access a workspace or plugin:
Verify you're a member: tessl workspace list-members <workspace-name>
Check your role has appropriate permissions (see Roles)
Ensure you're logged in: tessl whoami
Getting Help
If you continue to experience issues:
Run tessl doctor --json to capture diagnostic information
