public-files

# Public Files Commands target the current Space by default; add `-s <spaceId>` to use another. ## Publish Upload one file or one directory: ```bash cohub public upload <source> [destination] ``` Examples: ```bash cohub public upload ./report.pdf cohub public upload ./report.pdf reports/latest.pdf cohub public upload ./dist demo ``` Use `--json` for a manifest of every uploaded file (path, size, MIME type) plus the Space URL prefix. Existing files are never replaced implicitly. When replacement is intended, use: ```bash cohub public upload <source> [destination] --overwrite ``` ## Inspect ```bash cohub public ls [path] cohub public ls -r [path] cohub public url <path> ``` ## Behavior notes - Uploads are permanent: there is no delete command yet. Anything uploaded stays publicly accessible. - A URL prefix is not a browsable directory; always link to a specific file. - The CDN caches content for ~5 minutes. After `--overwrite`, the old version may remain visible briefly; query strings do not bypass the cache. ## Safety - Never upload secrets, tokens, private logs, or internal-only files. - Use relative asset paths in static sites. - Use `--overwrite` only when replacing the existing public path is intentional. ## Finish Return the direct public URL when the command provides one.