Skip to content

Getting started

Install the CLI, sign in, and publish your first artifact. Then add the skill and MCP server so your agent can publish for you.

You need

  • macOS or Linux, and a terminal with curl.
  • A werkbucket account. If you don't have one, wb login makes one in your browser: you choose a subdomain and a plan, then add a card at checkout.

Install the CLI

  1. Install

    Installs the wb command in ~/.local/bin and adds the agent skill to Claude Code. If that folder is not on your PATH, the script tells you what to add.

    Terminal
    curl -fsSL https://werkbucket.com/install.sh | sh
  2. Sign in

    Opens your browser with a one-time code. Approve it and the CLI stores its own token. The token is listed under API tokens in the dashboard, named after your computer, and you can revoke it there.

    Terminal
    wb login
  3. Publish a folder

    Point it at any file or folder. The command prints the URL. A folder's index.html is its page, and a folder without one serves its files by path. New artifacts are unlisted: anyone with the link can open them.

    Terminal
    wb publish ./dist✓ https://sean.werkbucket.com/dist/   (14 files, 2.4 MB sent)

Add the agent skill

The skill teaches your agent when and how to publish: which folder to send, which access mode to use, and how to share the link.

  1. Install the skill

    The installer already added the skill to Claude Code. For another agent, pass --agent with claude, codex, cursor, gemini or agents. Add --project to install it in the current folder instead of your home folder.

    Terminal
    wb skill install --agent codex

Connect a local agent

These run the MCP server on your machine through the CLI. It uses the token from wb login. For ChatGPT and Claude Cowork, use the remote server. Their guides are in the list of guides.

  1. Claude Code

    Adds the server to Claude Code's user config, ~/.claude.json.

    Terminal
    wb mcp install --client claude-code
  2. Cursor

    Adds the server to ~/.cursor/mcp.json.

    Terminal
    wb mcp install --client cursor
  3. Claude Desktop

    Adds the server to Claude Desktop's config. This works on macOS only.

    Terminal
    wb mcp install --client claude-desktop
  4. Ask your agent

    Restart the client, then ask:

    Publish the dist folder to werkbucket as unlisted and give me the link.