# 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="https://1171143958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXbWzspFdXV0HNujz6gJ9%2Fuploads%2FbHUvXXcgLevTwvpEIpnc%2Fimage.png?alt=media&#x26;token=38246688-b56d-4116-bdc0-30172c52d6ad" 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. Check that dependencies are already installed before running `tessl init`
3. For installing skills from GitHub, `tessl install <skill> -v` will provide verbose messaging, showing warning details. Similarly `-v` can be used in searching for those skills with `tessl skill search <skill> -v` &#x20;
4. Run `tessl doctor` to identify configuration issues
5. Try running with explicit flags: `tessl install --project-dependencies`

### 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](https://docs.tessl.io/reference/roles))
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](https://docs.tessl.io/support/faqs) for common questions
* [Give feedback](https://docs.tessl.io/support/giving-feedback) or report issues to the Tessl team