BST-ARTIFACT(1)

💖 bst-artifact — the bst artifact manual, bestie edition 💖

okay so you wanna mess with your cached artifacts? say less. this is bst artifact, straight out of the bst artifact Manual (that's the manual name, iykyk 🫶).

---

✨ NAME ✨

bst-artifact — manipulate cached artifacts. that's it. that's the whole job. 💅

---

🎀 SYNOPSIS 🎀

bst artifact [OPTIONS] COMMAND [ARGS]...

---

🦋 DESCRIPTION 🦋

Manipulate cached artifacts. no cap, that's the vibe.

some subcommands take artifact references as arguments. and bestie, artifacts can be specified in two ways:

• artifact refs: triples of the form <project name>/<element name>/<cache key>
• element names

when you give elements, the artifact gets looked up by observing the element and it's current cache key. ✨

the commands also support shell-style wildcard expansion:

• ? matches a single character
• * matches zero or more characters but does not match the / path separator
• ** matches zero or more characters including / path separators

and here's the tea 🍓: if the wildcard expression ends with .bst, then it will be used to search element names found in the project. otherwise, it will be used to search artifacts that are present in the local artifact cache. periodt.

some example arguments are:

• myproject/hello/8276376b077eda104c812e6ec2f488c7c9eea211ce572c83d734c10bf241209f
• myproject/he*/827637*
• core/*.bst (all elements in the core directory)
• **.bst (all elements)
• myproject/** (all artifacts from myproject)
• myproject/myelement/* (all cached artifacts for a specific element)

---

👑 COMMANDS 👑

• show — show the cached state of artifacts. see bst artifact-show(1) for full documentation on the show command. 👀
• checkout — checkout contents of an artifact. see bst artifact-checkout(1) for full documentation on the checkout command. 🎀
• pull — pull a built artifact. see bst artifact-pull(1) for full documentation on the pull command. 🫶
• push — push a built artifact. see bst artifact-push(1) for full documentation on the push command. 🔥
• log — show logs of artifacts. see bst artifact-log(1) for full documentation on the log command. 📜
• list-contents — list the contents of an artifact. see bst artifact-list-contents(1) for full documentation on the list-contents command. 🧚
• delete — remove artifacts from the local cache. see bst artifact-delete(1) for full documentation on the delete command. 💀

---

ngl that's the whole page. go forth and manipulate those artifacts, main character. 🌈

mwah 💋 this was version 2.5, dated 2025-05-09 — bye bestie, slay responsibly ✨