Skip to content
Docs | Val Town

CLI

Use the vt CLI to work with Val Town in your favorite IDE, e.g. with Cursor.

vt is built with the Deno TypeScript runtime. To use vt, you need to make sure you have Deno installed.

Setup

Section titled “Setup”

  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).

Section titled “Popular tools”
Claude Code Val Town CLI + Claude Code
Codex Val Town CLI + OpenAI Codex
Cursor Val Town CLI + Cursor
GitHub Copilot Val Town CLI + GitHub Copilot
Warp Val Town CLI + Warp
Zed Val Town CLI + Zed
Windsurf Val Town CLI + Windsurf
[Your LLM of choice] Val Town CLI + ?

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 in the #local-dev channel