Skip to main content

​
Authentication Status

Check your current auth configuration: 
copera auth status
Output: 
{
  "profile": "default",
  "token_source": "environment variable COPERA_CLI_AUTH_TOKEN",
  "token": "cp__***...***xY2z",
  "configured": true
}
The token_source field tells you where the CLI found your token (environment variable, config file, or --token flag).

​
Cache

The CLI caches document content locally for faster reads. Manage the cache with:

​
Check cache status

copera cache status
Output: 
{
  "bytes": 4280,
  "files": 6,
  "path": "/var/folders/.../copera-cli-0.3.0"
}

​
Clear cache

copera cache clean
Use copera docs content <id> --no-cache to bypass the cache for a single request without clearing it entirely.

​
Version

copera version
Output: 
{
  "build_time": "2026-03-28T10:22:05Z",
  "schema_version": "1",
  "version": "0.3.0"
}

​
Update

copera update                  # update to latest
copera update --version 1.2.0  # pin to specific version
copera update --force          # skip confirmation prompt

​
Shell Completion

Enable tab completion for your shell: 
# Bash
copera completion bash >> ~/.bashrc

# Zsh
copera completion zsh >> ~/.zshrc

# Fish
copera completion fish > ~/.config/fish/completions/copera.fish
After adding the completion, restart your shell or run source ~/.zshrc (or equivalent) to activate.