Townie is an AI-powered development assistant that lets you edit Val Town projects using Claude 4 Sonnet.

Townie uses agentic tool-calling, taking many read, write, testing steps autonomously when carrying out your instructions.

• AI-Assisted Editing: Chat with Claude 4 Sonnet about your code and let it make changes directly to your project files
• Branch Management: View, select, and create branches without leaving the app
• Sound Notifications: Get alerted when Claude finishes responding
• Mobile-Friendly: Works on both desktop and mobile devices

1. Login: Authenticate with your Val Town API token and Anthropic API key
2. Select a Project: Choose which Val Town project you want to work on
3. Select Files: Browse your project files and select which ones to include in the context window
4. Chat with Claude: Describe what you want to build or modify, and Claude will help implement it
5. Branch Management: Create and switch between branches to organize

Townie is fully open-source and itself runs on Val Town.

To get Townie running in your Val Town account click the Remix button and then add your ANTHROPIC_API_KEY. You can leave all the other environment variables blank.

Authentication in Townie is handled via Val Town Oauth. However, we have not yet opened up our OAuth to anyone else, which currently makes it very awkward to use your own Townie. Here is a temporary workaround:

1. Login to the official Townie
2. Copy your _session cookie (via the Application tab in the Developer Tools)
3. Add in that _session cookie in your personal Townie

If you have any questions, please reach out at townie@val.town. We're happy to help.