Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

CLI Doctor

Run diagnostic checks to troubleshoot issues.

doctor command

pinner doctor

Example Output

Version: 0.1.0
OS: linux/amd64
Config: /home/user/.config/pinner/config.json
Config Status: Found
Endpoint: https://api.pinner.xyz
Memory limit: 100 MB
Max retries: 3
Authentication: Authenticated
Shell completion: Enabled (bash, zsh)

JSON Output

pinner doctor --json

Returns structured JSON with all diagnostic information.

What Gets Checked

CheckDescription
VersionCLI version and build info
OSOperating system and architecture
ConfigConfiguration file location and status
EndpointAPI endpoint configuration
Memory limitCAR generation memory limit
Max retriesMaximum retry attempts
AuthenticationWhether a token is configured
Shell completionWhich shells have completion enabled

Use Cases

Use pinner doctor when:

  • Reporting bugs or issues
  • Troubleshooting connection problems
  • Verifying your configuration
  • Checking authentication status
  • Ensuring CLI is properly installed