Joiner

Appearance

Create an activity with Claude Code ​

Build and publish a Joiner activity end-to-end from the Claude Code desktop app — no coding and almost no terminal. You do a short one-time setup; after that, Claude Code installs the tools, scaffolds an activity, builds it with you, and publishes it to a live link.

This flow targets macOS.

1. One-time setup ​

  1. Install Claude Code (desktop app) from Anthropic and sign in.

  2. Install bun — one line in Terminal. Open the macOS Terminal app, paste the one-line installer from bun.sh, and press Enter. This is the only time you touch the Terminal. It also writes bun onto your shell profile, which is what lets Claude Code find bun afterward.

  3. Download the starter folder and unzip it:

    Download poe-tile-starter.zip

  4. Open the folder in Claude Code (File → Open) and click "Trust this folder" when prompted. You will be asked once.

2. Kick it off ​

Paste this into Claude Code and replace the last part with your idea:

I want to build a Joiner activity. Read BOOTSTRAP.md and follow it to set up
this folder, then help me build: <describe your idea here>.

When Claude signs you in to Joiner, a browser window opens — approve it there. You never paste an API key. From then on Claude verifies bun, installs the poe-tiles CLI, scaffolds your activity, builds it with you, keeps the source private (owner-only) by default, publishes it, and hands back a live link.

Trust and safety ​

The starter folder is a trusted-code workspace, generated from the Joiner repository. Its .claude/settings.json lets Claude Code run bun and poe-tiles — the tools that build and publish your activity — without prompting for each command, and denies risky commands (curl, bash, sh, rm -rf) and reading .env secrets. Running bun/poe-tiles is effectively running local code, which is inherent to building an activity; only trust the folder because it comes from us.

To revoke workspace trust: remove the folder from Claude Code's trusted workspaces, or delete the folder. To end the CLI session: run poe-tiles auth logout. Legacy Poe API keys are separate; regenerate those at poe.com.

Prefer the terminal? ​

If you are comfortable in a terminal, you can skip the starter folder and use the CLI directly — see the Getting started guide.