SkillsAdd

smithery/neversight

val-town-cli

Manage Val Town projects using the vt CLI.

Installation

$ npx skills add smithery/neversight --skill val-town-cli
View on skills.sh ↗ Website ↗

Summary

  • Manage Val Town projects using the vt CLI.
  • Use when working with Vals (Val Town serverless functions), syncing code to Val Town, creating HTTP endpoints, streaming logs, or managing Val Town branches.
  • Triggers on tasks involving Val Town development, val creation/editing, or when user mentions "vt", "val town", or "vals".

Also in this package

Other skills from smithery/neversight · top by installs.

npx skills add smithery/neversight
zoom-meeting 0 ziwei-doushu 0 zimage-skill 0 zig 0 zhimeng-agent 0 zfc 0 zenbin 0 zeberg-salomon-rotator 0 zdev 0 youtube-transcript 0

Browse all from smithery/neversight

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,699 B
  • docs SUMMARY.md 343 B

History

  1. First recorded snapshot · 0 installs

SKILL.md

Val Town CLI

The vt CLI manages Val Town projects locally. Key concepts:

  • Val: A serverless function/project hosted on Val Town
  • HTTP Val: A val that serves HTTP requests (filename must contain "http", e.g., index.http.tsx)
  • Branch: Version control within a val (not git branches)

Quick Reference

Task Command
Create new val vt create my-val
Clone existing vt clone username/valName
Push changes vt push
Pull updates vt pull
Auto-sync vt watch
View in browser vt browse
Stream logs vt tail
Check status vt status
List your vals vt list

Common Workflows

Create and develop a new val

vt create my-api
cd my-api
# Edit files...
vt push
vt browse  # Open in browser

Clone and modify existing val

vt clone username/valName
cd valName
# Edit files...
vt push

Live development with auto-sync

cd my-val
vt watch  # Syncs on every file save

Work on a feature branch

cd my-val
vt checkout -b my-feature
# Make changes...
vt push
vt checkout main

File Naming Conventions

Val Town detects file types by naming patterns:

Pattern Val Type
.http.ts, .http.tsx HTTP endpoint
*.cron.ts Scheduled cron job
*.email.ts Email handler
Other .ts/.tsx files Script val

Example: To create an HTTP API, name the file api.http.ts or index.http.tsx.

Command Details

Create

vt create my-val                    # New val in ./my-val
vt create my-val ./existing-folder  # Upload existing files
vt create my-val --private          # Private val
vt create my-val --org-name myorg   # Under an organization

Clone

vt clone                                    # Interactive selection
vt clone username/valName                   # By name
vt clone https://www.val.town/x/user/val    # By URL
vt clone username/valName .                 # Into current directory

Remix

Fork someone else's val:

vt remix std/reactHonoStarter myWebsite
cd myWebsite
vt watch

Branches

vt branch              # List branches
vt checkout main       # Switch branch
vt checkout -b feature # Create new branch
vt branch -D feature   # Delete branch

Logs

vt tail                          # Stream current val's logs
vt tail @user/valName            # Stream specific val
vt tail --print-headers          # Include HTTP headers
vt tail --reverse-logs           # Latest first

Configuration

vt config options                           # List options
vt config set dangerousOperations.confirmation false  # Disable confirmations
vt config ignore                            # Edit global .vtignore

Project Structure

After cloning/creating, a val directory contains:

  • .vt/ - Metadata (like .git)
  • .vtignore - Files to exclude from sync
  • deno.json - Deno LSP configuration
  • Source files (.ts, .tsx, etc.)

Tips

  • Use vt push --dry-run to preview changes before pushing
  • Use vt checkout --dry-run to preview branch switch effects
  • HTTP vals require "http" in the filename to be recognized as endpoints
  • The vt watch command enables live reloading with the browser companion extension