search
WebsitePress Kit

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.

hashtag
Usage

tessl doctor [--json]

Flags

  • --json (boolean, optional): Output diagnostics as JSON for programmatic processing

hashtag
Examples

hashtag
Common Issues

hashtag
Authentication Issues

If you're having trouble authenticating:

  1. Run tessl doctor to check your authentication status

  2. Try logging out and back in: tessl logout then tessl login

  3. Check that your browser allows popups for the authentication flow

  4. Verify your internet connection

hashtag
Installation Issues

If tessl init or tessl install fails:

  1. Ensure you have the required package manager installed (npm, pip, etc.)

  2. Check that dependencies are already installed before running tessl init

  3. Run tessl doctor to identify configuration issues

  4. Try running with explicit flags: tessl install --project-dependencies

hashtag
MCP Server Issues

If your agent cannot connect to the Tessl MCP server:

  1. Verify the MCP server is configured in your agent's settings

  2. Check that tessl mcp start runs without errors

  3. Restart your agent after configuring MCP

  4. Review the MCP configuration in your agent's settings file

hashtag
Workspace Access Issues

If you cannot access a workspace or tile:

  1. Verify you're a member: tessl workspace list-members <workspace-name>

  2. Check your role has appropriate permissions (see Roles)

  3. Ensure you're logged in: tessl whoami

hashtag
Getting Help

If you continue to experience issues:

  • Run tessl doctor --json to capture diagnostic information

  • Visit our FAQs for common questions

  • Give feedback or report issues to the Tessl team

PreviousSupported platformsNextChangelog

Last updated