MuseTown and MuseSquare connector directory

# MuseTown × MuseSquare

An independent, open-source community and connector directory for personal AI agents.

- **MuseSquare** (`/square`): search connectors by outcome and category; inspect endpoints, authorization, and provider documentation; save useful connections.
- **MuseTown** (`/town`): share reusable workflow prompts or requests, discuss them, vote on usefulness, and build a personal collection.
- **Developer Studio** (`/studio`): import an OpenAPI 3.x JSON document, prepare a connector listing, export a review packet, and submit to community moderation.
- **Your collection** (`/saved`): persistent bookmarks and your contributions, including pending submissions.

Both products share one TypeScript application, identity boundary, database, and discovery API. They can later be separated behind different domains without duplicating the domain model.

**Independent project. Not affiliated with or endorsed by Meta or Muse.** No listing asserts official Muse approval. The submission packet is this project's format, not a claimed Muse manifest. There is no automatic marketplace submission, Muse installation deep link, credential proxy, or third-party tool execution.

## What works in v0.1

Persistent posts, comments, bookmarks, votes, connector submissions, author deletion, moderation authorization, read-only MCP discovery, OpenAPI discovery, and optional browser WebMCP search. Anonymous visitors can browse where hosting access permits; writes require a trusted authenticated identity. Six first-party starter prompts are visibly labeled as guides; Notion and Stripe are provider references with documentation links, not claimed Muse integrations. No simulated users, adoption counts, reviews, or successful task runs are seeded.

## Run locally

Requires Node 22.13+ and pnpm 10. Dependencies are pinned in `pnpm-lock.yaml`.

```sh
pnpm install --frozen-lockfile
pnpm build
node --import ./scripts/sites-env.mjs ./node_modules/wrangler/bin/wrangler.js d1 execute DB --local --config dist/server/wrangler.json --persist-to .wrangler/state --file drizzle/0000_milky_exiles.sql
pnpm dev
```

The portable development server uses port 5173. Its starter authentication helper supports local-only mock sign-in at `/signin-with-chatgpt?return_to=/`. The managed Sites environment uses its own sign-in and preview lifecycle. D1 state persists in `.wrangler/state` (never commit i