# 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 <a href="#tessl-doctor" id="tessl-doctor"></a>

```
tessl doctor [--json]
```

**Flags**

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

<figure><img src="/files/6A8twIvdpsRavlFBOomQ" alt=""><figcaption></figcaption></figure>

#### **Examples**

```
# Run diagnostics with human-readable output
tessl doctor

# Output diagnostics as JSON
tessl doctor --json
```

## Common Issues

### 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

### Installation Issues

If `tessl init` or `tessl install` fails:

1. Ensure you have the required package manager installed (npm, pip, etc.)
2. For installing skills from GitHub, `tessl install <skill> -v` will provide verbose messaging, showing warning details.
3. Run `tessl doctor` to identify configuration issues

### 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

### 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](/reference/roles.md))
3. Ensure you're logged in: `tessl whoami`

## Getting Help

If you continue to experience issues:

* Run `tessl doctor --json` to capture diagnostic information
* Visit our [FAQs](/support/faqs.md) for common questions
* [Give feedback](/support/giving-feedback.md) or report issues to the Tessl team


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tessl.io/support/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.