CLI Reference

Commands

slop drop <file> [path]

Upload a file. If path is omitted, uses the filename.

slop drop ./report.md                    # → report.md
slop drop ./report.md research/q1.md     # → research/q1.md

slop list [project]

List drops. Shows path, size, last modified, version.

slop list              # All projects
slop list research     # Just the research project
slop list -l           # Long format with sizes

slop cat <path>

Print file contents to stdout.

slop cat research/analysis.md
slop cat research/analysis.md | less

slop watch

Watch current directory for changes and auto-sync.

slop watch                    # Watch current project
slop watch --global           # Watch all configured projects
slop watch --global --initial-sync  # Also sync existing files on start

slop init

Initialize a project in the current directory. Creates .slop config.

slop init
slop init --project my-docs --patterns "docs/**/*.md"

slop login

Authenticate via browser. Credentials stored at ~/.config/slop/credentials.json.

slop token

Manage API tokens for CI/CD.

slop token create --name "ci" --expires 90d
slop token list
slop token revoke <prefix>

slop global

Manage multi-project global watch configuration.

slop global list       # Show all configured projects
slop global add <tenant> <project> <path>
slop global validate   # Check config for errors

Config: ~/.slop/global.yaml

slop whoami

Show current authentication status — tenant, user, token info.

slop status

Show sync status for current project — pending uploads, last sync time.

Global Flags