or run

npx @tessl/cli init
Log in

Version

Tile

Overview

Evals

Files

docs

analysis.mdconfiguration.mdeditor-integration.mdformatting.mdindex.mdutilities.md
tile.json

utilities.mddocs/

Information and Utility Commands

Commands for version information, help, shell completions, cache management, and system utilities. These commands support development workflows and system integration.

Capabilities

Version Information

Display version information for dprint and its components.

# Display version information
dprint version
dprint -v
dprint -V  
dprint --version

Usage Examples:

# Standard version output
dprint version
# Output: dprint 0.50.1

# Version information includes:
# - dprint binary version
# - Build information
# - Platform details

Help System

Comprehensive help information for commands and options.

# General help
dprint help
dprint --help
dprint -h

# Command-specific help
dprint <COMMAND> --help

Usage Examples:

# General help
dprint help

# Format command help
dprint fmt --help

# Configuration help
dprint config --help

# Get help when no arguments provided
dprint  # Shows help automatically

Shell Completions

Generate shell completion scripts for various shells to enable tab completion.

# Generate completions for specific shell
dprint completions <SHELL>

# Supported shells:
# - bash
# - zsh  
# - fish
# - powershell

Usage Examples:

# Generate bash completions
dprint completions bash

# Generate zsh completions  
dprint completions zsh

# Generate fish completions
dprint completions fish

# Generate PowerShell completions
dprint completions powershell

Installation Examples:

# Bash completion installation
dprint completions bash > ~/.local/share/bash-completion/completions/dprint

# Zsh completion installation
dprint completions zsh > ~/.zsh/completions/_dprint

# Fish completion installation
dprint completions fish > ~/.config/fish/completions/dprint.fish

# PowerShell completion installation (Windows)
dprint completions powershell | Out-String | Invoke-Expression

Cache Management

Manage dprint's internal caches for plugins and formatting results.

# Clear all caches
dprint clear-cache

Usage Examples:

# Clear all caches (plugins, formatting results, etc.)
dprint clear-cache

# Use cases:
# - Plugin loading issues
# - Outdated formatting cache
# - Storage space cleanup
# - Development/debugging

Cache Types Cleared:

  • Plugin download cache
  • Plugin compilation cache
  • Incremental formatting cache
  • Configuration resolution cache
  • File change detection cache

License Information

Display license information for dprint and its dependencies.

# Display license information
dprint license

Usage Examples:

# Show license text
dprint license

# Output includes:
# - dprint license (MIT)
# - Third-party dependency licenses
# - Copyright information

Upgrade Management

Update dprint to the latest available version.

# Upgrade to latest version
dprint upgrade

Usage Examples:

# Check for and install latest version
dprint upgrade

# Upgrade process:
# 1. Check current version
# 2. Query latest available version
# 3. Download and install if newer version available
# 4. Verify installation

Upgrade Behavior:

  • Preserves existing configuration
  • Updates binary in-place
  • Handles platform-specific installation
  • Provides upgrade progress feedback

System Integration

Environment Variables

# Cache directory override
DPRINT_CACHE_DIR=/custom/cache/path

# Disable upgrade checks
DPRINT_NO_UPGRADE_CHECK=1

# Configuration file override
DPRINT_CONFIG=/path/to/dprint.json

Exit Codes

# Standard exit codes for utility commands
0   # Success
1   # General error
10  # Argument parsing error

Platform Support

# Supported platforms:
# - Linux (x86_64, aarch64)
# - macOS (x86_64, aarch64)  
# - Windows (x86_64)

# Platform-specific features:
# - Windows: Registry integration
# - macOS: Homebrew integration
# - Linux: Package manager integration

Development Integration

CI/CD Integration

# CI pipeline examples

# GitHub Actions
- name: Check formatting
  run: dprint check

- name: Install dprint
  run: |
    curl -fsSL https://dprint.dev/install.sh | sh
    export PATH="$HOME/.dprint/bin:$PATH"

# GitLab CI
script:
  - dprint check --allow-no-files

# Jenkins
stage('Format Check') {
  steps {
    sh 'dprint check'
  }
}

Package Manager Integration

# package.json scripts
{
  "scripts": {
    "format": "dprint fmt",
    "format:check": "dprint check",
    "format:diff": "dprint fmt --diff",
    "lint": "dprint check && eslint src/",
    "precommit": "dprint check --staged"
  }
}

# Makefile integration
.PHONY: format check
format:
	dprint fmt

check:
	dprint check

install-dprint:
	cargo install dprint

Editor Integration Setup

# VS Code settings.json
{
  "dprint.path": "/path/to/dprint",
  "editor.defaultFormatter": "dprint.dprint",
  "editor.formatOnSave": true
}

# Vim/Neovim configuration
autocmd BufWritePre * :!dprint fmt %

# Emacs configuration  
(add-hook 'before-save-hook 'dprint-format-buffer)

Troubleshooting

Common Issues

# Command not found
which dprint  # Check if dprint is in PATH
echo $PATH    # Verify PATH includes dprint location

# Permission errors
chmod +x ~/.dprint/bin/dprint  # Fix executable permissions

# Cache issues
dprint clear-cache  # Clear corrupted cache

# Version conflicts
dprint upgrade      # Update to latest version

Debug Information

# Verbose output for debugging
dprint --log-level debug <command>

# System information
dprint version  # Check version
env | grep DPRINT  # Check environment variables

# Configuration debugging
dprint output-resolved-config  # Check resolved config

Performance Optimization

# Cache optimization
export DPRINT_CACHE_DIR=/fast/storage/path

# Process optimization
ulimit -n 4096  # Increase file descriptor limit

# Network optimization (for plugin downloads)
export HTTP_PROXY=http://proxy:8080
export HTTPS_PROXY=http://proxy:8080