Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.murmur.dev/llms.txt

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

Uploads one or more files and prints a public HTTPS URL for each one. The content type is detected automatically from the file extension, or by inspecting the file contents when the extension is unrecognized. Uploaded files are publicly accessible at the returned URLs. Use this to share screenshots, logs, or other artifacts from an agent session.

​
Synopsis

murmur upload [flags] <file> [file...]

​
Arguments

NameTypeRequiredDescription
filestringyesOne or more file paths to upload. Repeatable.
--workspacestringnoWorkspace name. Overrides the value from murmur.yaml.

​
Examples

​
Upload a single file

murmur upload screenshot.png

https://storage.googleapis.com/murmur-uploads/abc123-screenshot.png

​
Upload multiple files

murmur upload report.pdf debug.log screenshot.png

https://storage.googleapis.com/murmur-uploads/d4e5f6-report.pdf
https://storage.googleapis.com/murmur-uploads/a1b2c3-debug.log
https://storage.googleapis.com/murmur-uploads/f7g8h9-screenshot.png
One URL is printed per file, in the order the files were specified. If any file fails, the command exits immediately without uploading remaining files.

​
Upload with an explicit workspace

murmur upload --workspace backend coverage.html

https://storage.googleapis.com/murmur-uploads/j0k1l2-coverage.html

​
Errors

CodeMeaningWhat to do
file open failureThe specified file does not exist or is not readable.Check the file path and permissions.
UNAUTHENTICATEDIdentity token is missing or expired.Run murmur auth or check your murmur.local.yaml configuration.
INVALID_ARGUMENTThe file exceeds the 100 MiB upload limit, or the filename is empty.Reduce the file size or check the file path.
FAILED_PRECONDITIONThe uploads bucket is not configured for this deployment.Contact your administrator.