cloudstic completion

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Cloudstic/cli/llms.txt

Use this file to discover all available pages before exploring further.

​

Usage

cloudstic completion <shell>

​

Supported Shells

• bash — Bourne Again Shell
• zsh — Z Shell
• fish — Friendly Interactive Shell

​

Installation

# Bash
cloudstic completion bash

# Zsh
cloudstic completion zsh

# Fish
cloudstic completion fish

source <(cloudstic completion bash)

# Add to ~/.bashrc or ~/.bash_profile
echo 'source <(cloudstic completion bash)' >> ~/.bashrc

cloudstic completion bash > /etc/bash_completion.d/cloudstic

source <(cloudstic completion zsh)

# Add to ~/.zshrc
echo 'source <(cloudstic completion zsh)' >> ~/.zshrc

cloudstic completion zsh > "${fpath[1]}/_cloudstic"

cloudstic completion fish | source

# Fish automatically loads completions from ~/.config/fish/completions/
cloudstic completion fish > ~/.config/fish/completions/cloudstic.fish

exec $SHELL

exec fish

cloudstic <TAB>
# Shows: init backup restore list ls prune forget diff break-lock key cat completion version help

​

Features

​

Commands and Subcommands

cloudstic <TAB>
# Shows all available commands

cloudstic key <TAB>
# Shows: list add-recovery passwd

​

Flags and Options

cloudstic backup -<TAB>
# Shows: -source -source-path -drive-id -root-folder -tag -dry-run
# Plus all global flags

cloudstic init -<TAB>
# Shows: -recovery -no-encryption
# Plus all global flags

​

Flag Values

cloudstic backup -source <TAB>
# Shows: local sftp gdrive gdrive-changes onedrive onedrive-changes

cloudstic -store <TAB>
# Shows: local b2 s3 sftp

​

File Path Completion

cloudstic backup -source-path <TAB>
# Shows directory completions from your filesystem

cloudstic restore -output <TAB>
# Shows file completions

​

Context-Aware Completions

cloudstic backup -source local -<TAB>
# Shows backup-specific flags and global flags

cloudstic key passwd -<TAB>
# Shows: -new-password (plus global flags)

​

Completion Examples

​

Completing Store Types

$ cloudstic backup -store <TAB>
local  b2  s3  sftp

​

Completing Source Types

$ cloudstic backup -source <TAB>
local  sftp  gdrive  gdrive-changes  onedrive  onedrive-changes

​

Completing Subcommands

$ cloudstic <TAB>
init        backup      restore     list        ls          prune
forget      diff        break-lock  key         cat         completion
version     help

​

Completing Shell Types

$ cloudstic completion <TAB>
bash  zsh  fish

​

Troubleshooting

​

Bash: Completions not working

1. Ensure bash-completion package is installed:
   # Ubuntu/Debian
   sudo apt-get install bash-completion
   
   # macOS
   brew install bash-completion@2
   
2. Verify bash-completion is loaded in your .bashrc:
   # Add if missing
   if [ -f /etc/bash_completion ]; then
     . /etc/bash_completion
   fi
   

​

Zsh: Command not found: compdef

1. Enable compinit in your .zshrc before sourcing the completion:
   autoload -Uz compinit
   compinit
   source <(cloudstic completion zsh)
   

​

Fish: Completions not appearing

1. Check that the completion file was created:
   ls ~/.config/fish/completions/cloudstic.fish
   
2. Reload completions:
   fish_update_completions
   

​

General: Old completions cached

# Bash: Clear completion cache
hash -r

# Zsh: Clear completion cache
rm ~/.zcompdump*
compinit

# Fish: Reload completions
fish_update_completions

​

Available Completions

​

Global Flags (available in all commands)

• -store → local, b2, s3, sftp
• -store-path → file path completion
• -store-prefix → free text
• -s3-endpoint → free text
• -s3-region → free text
• -s3-access-key → free text
• -s3-secret-key → free text
• -sftp-host → hostname completion
• -sftp-port → free text (default: 22)
• -sftp-user → username completion
• -sftp-password → free text
• -sftp-key → file path completion
• -encryption-key → free text
• -encryption-password → free text
• -recovery-key → free text
• -kms-key-arn → free text
• -enable-packfile → boolean flag
• -verbose → boolean flag
• -quiet → boolean flag
• -debug → boolean flag

​

Command-Specific Flags

• -recovery
• -no-encryption

• -source → local, sftp, gdrive, gdrive-changes, onedrive, onedrive-changes
• -source-path → file path completion
• -drive-id → free text
• -root-folder → free text
• -tag → free text (repeatable)
• -dry-run

• -output → file path completion (default: ./restore.zip)
• -path → free text
• -dry-run

• -dry-run

• -prune
• -dry-run
• -keep-last → number
• -keep-hourly → number
• -keep-daily → number
• -keep-weekly → number
• -keep-monthly → number
• -keep-yearly → number
• -tag → free text (repeatable)
• -source → free text
• -account → free text
• -path → free text
• -group-by → free text (default: source,account,path)

• -json

• -new-password → free text

• -read-data
• -snapshot → free text

​

Notes

• Performance: Completions are generated dynamically based on the current command context
• File completions: File and directory paths use native shell completion capabilities
• No external dependencies: Completion scripts are self-contained and don’t require network access
• Automatic updates: Regenerate completions after upgrading Cloudstic to get the latest commands and flags

​

Related Commands

• — Display usage information
• — Print version information