{
  "$type": "site.standard.document",
  "description": "Write your scripts on the internet, from your terminal, or in any editor",
  "path": "/vt-cli",
  "publishedAt": "2025-09-10T00:00:00.000Z",
  "site": "at://did:plc:a2rdzfdxkjwerrfrpbwcipb2/site.standard.publication/3jd443afc2222",
  "textContent": "Introducing vt, the CLI for Val Town that lets you use your favorite editors\nand local tools. Now you can use VS Code, Claude Code, Codex and more with our\nsuper-fast feedback loop, deploying software instantly as you develop it.\n\n<video\n  src=\"https://filedumpthing.val.run/blob?key=blobfile1748008498288demo.mp4\"\n  controls\n  autoplay\n  style=\"width: 100%; height: auto; aspect-ratio:  1645/1080; border: 1px solid #000;\"\n/>\n\nTo get vt,\ninstall Deno,\nthen run\n\n\n\nWith vt, you can:\n\n- Use  to watch a folder for changes, pushing updates and redeploying\n  instantly as you save\n- Remix or create brand-new Val Town projects directly from your command line\n- Livestream logs from your Val directly to your terminal\n- Manage branches, switching between separate deployments or prod & dev branches\n  of a project\n\nWe designed vt to work much like , so  and  work\njust like you'd expect. But the real magic is in the  command: vt can\nresolve deltas between Val Town and a local folder of TypeScript and text files,\nautomatically detecting file changes like renames and modifications. As you edit\nin VS Code, neovim, or your favorite editor, every time you save the changes go\nlive. Or, if you don't want to live on the edge, you can use  to\nexplicitly push new changes.\n\nBring your own editor - and LLMs!\n\n<div style=\"position: relative; padding-top: 61.36363636363637%;margin-bottom: 2em; border: 1px solid #000;\">\n  <iframe\n    src=\"https://customer-cchzc454ej3jhb72.cloudflarestream.com/8faac55240d7e45b04e04f0fab11bd0a/iframe?muted=true&preload=true&poster=https%3A%2F%2Fcustomer-cchzc454ej3jhb72.cloudflarestream.com%2F8faac55240d7e45b04e04f0fab11bd0a%2Fthumbnails%2Fthumbnail.jpg%3Ftime%3D%26height%3D600\"\n    loading=\"lazy\"\n    style=\"border: none; position: absolute; top: 0; left: 0; height: 100%; width: 100%;\"\n    allow=\"accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture;\"\n    allowfullscreen=\"true\"\n  ></iframe>\n</div>\n\nvt works perfectly with your favorite LLM tools: it can even initialize a\nAGENTS.md file that contains all of the context necessary\nto write code for the Val Town platform.\n\nPeople are already using vt to build cool projects, like\nGeoffrey Litt's Stevens\nproject, a really cool AI personal assistant telegram bot, built locally with\ncursor and vt. We built Val Town's new Val search\non Val Town itself, with Claude Code and vt.\n\nUse the companion browser extension\n\n<div style=\"position: relative; padding-top: 54.87804878048781%;margin-bottom:2em;border: 1px solid #000;\">\n  <iframe\n    src=\"https://customer-cchzc454ej3jhb72.cloudflarestream.com/39c35e5244e103f5bfb2c743752cb7ba/iframe?muted=true&preload=true&poster=https%3A%2F%2Fcustomer-cchzc454ej3jhb72.cloudflarestream.com%2F39c35e5244e103f5bfb2c743752cb7ba%2Fthumbnails%2Fthumbnail.jpg%3Ftime%3D%26height%3D600\"\n    loading=\"lazy\"\n    style=\"border: none; position: absolute; top: 0; left: 0; height: 100%; width: 100%;\"\n    allow=\"accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture;\"\n    allowfullscreen=\"true\"\n  ></iframe>\n</div>\n\nvt also has a companion browser extension which pairs with  to\nautomatically reload the tab as you edit your Val.\n\nIt's available for\nChrome\nor Firefox.\n\nIf you have  running, it should \"just work\"! The companion\ncommunicates with vt's watcher over a local WebSocket connection.\n\nWe want feedback!\n\nvt is a big leap forward in the local development experience for Val Town. But\nwe're always looking to improve and polish the experience. If you have any\nfeedback we'd love to hear it. You can join our Discord server\nhere, and contribute ideas, PRs, or issues to\nthe val-town/vt GitHub repo.\n\n<img src='https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/6c37ffa5-3136-4528-c946-4643806d5100/public' alt='All editors supported' />",
  "title": "Introducing vt, the Val Town CLI"
}