Skip to content
Docs | Val Town

vt CLI

Setup

Section titled “Setup”

vt is built with the Deno TypeScript runtimet, so make sure you have Deno installed.

  1. Install the Val Town CLI: deno install -grAf jsr:@valtown/vt

  2. Run vt to login to Val Town

  3. vt create, vt remix, or vt clone a val. Select “Yes” to add editor files*

  4. cd into your val’s directory

  5. (Optional) vt checkout -b <branch> to isolate changes

  6. vt watch to sync your changes to Val Town as you save files

* This will include AGENTS.md, which LLMs should respect (with some exceptions, like CLAUDE.md).

Tips, Troubleshooting

Section titled “Tips, Troubleshooting”
  • Ask to list or examine your vals or read sqlite data, logs, etc.
  • Ask your LLM to edit vals and even agentically iterate
  • Broken code? Visit the Versions tab or History of your val to revert
  • Large changes? Use feature branches and merge when stable
  • Need help? Ask in the Val Town Discord server