Getting started
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
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.
Terminalcurl -fsSL https://werkbucket.com/install.sh | shSign 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.
Terminalwb loginPublish 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.
Terminalwb 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.
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.
Terminalwb 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.
Claude Code
Adds the server to Claude Code's user config, ~/.claude.json.
Terminalwb mcp install --client claude-codeCursor
Adds the server to ~/.cursor/mcp.json.
Terminalwb mcp install --client cursorClaude Desktop
Adds the server to Claude Desktop's config. This works on macOS only.
Terminalwb mcp install --client claude-desktopAsk your agent
Restart the client, then ask:
Publish the dist folder to werkbucket as unlisted and give me the link.