CLI

Markdown

Command not found

Verify the CLI is installed and in your PATH:

which devcaster

If not found, reinstall:

curl -fsSL https://devcaster.dev/install | bash

Or add to PATH:

echo 'export PATH="$HOME/.devcaster:$PATH"' >> ~/.bashrc && source ~/.bashrc

Authentication errors

Check current authentication:

devcaster whoami

Re-authenticate if needed:

devcaster logout
devcaster login

For CI/CD, use environment variable:

export DEVCASTER_API_KEY="your-api-key"

Type generation issues

Project type not detected

Use language-specific commands:

devcaster ts generate  # TypeScript
devcaster py generate  # Python

Output directory missing

Specify output directory explicitly:

devcaster generate --output-dir ./my-types

Debug CLI issues

Enable debug logging:

devcaster --log-level debug [command]

Check version compatibility:

devcaster version

Common issues

  • API key not found: Run devcaster login
  • Project type detection fails: Use language-specific commands or ensure you're in project root
  • Network timeout: Check internet connection and proxy settings
  • Permission denied: Check directory write permissions

Getting help