Caltech Library logo


Namaste (i.e. “NAMe AS TExt”) is a file naming convention to support primitive directory-level metadata tags exposed directly via filenames. As such, Namaste tags greet visitors who request a directory listing (e.g., Linux ‘ls’) with a glimpse of what the directory holds. This approach can be readily implemented as a library or as a command line tool. Prior implementations exist in Perl and Python. This implementation was written in Go. It includes support for namaste hosted on S3.

namaste command

The command namaste can be used to set, check or retrieve the “name as text” associated with a directory’s type, who, what, when and where metadata. If you use the -verbose option the values set or retrieved with be display to standard out.