Skip to content

Create a tile with Claude Code

Build and publish a Poe tile 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 a tile, 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 Poe tile. Read .claude/BOOTSTRAP.md and follow it to set up
this folder, then help me build: <describe your idea here>.

When Claude signs you in to Poe, 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 tile, 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 Poe Tiles repository. Its .claude/settings.json lets Claude Code run bun and poe-tiles — the tools that build and publish your tile — 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 a tile; only trust the folder because it comes from us.

To revoke: remove the folder from Claude Code's trusted workspaces, or delete the folder. To rotate credentials: run poe-tiles logout, or sign out / regenerate your key 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.