Client setup

Claude Code

Install the Vibiz plugin for Claude Code in one command. You get the MCP connection, five slash commands, a marketing subagent, and a post-commit nudge that turns shipped code into social posts.

One-line install

Open a terminal and run:

bash

npx @vibiz/vibiz

The script verifies Claude Code is installed, registers the Vibiz marketplace, installs the plugin, and prints what to do next.

Prerequisites

Claude Code installed. Either brew install claude-code or npm i -g @anthropic-ai/claude-code.
A Vibiz account. If you don't have one, the first authentication redirects you to vibiz.ai for sign-up.

After running the installer

Three small steps inside Claude Code:

bash

claude        # open Claude Code
/mcp          # MCP picker → choose "vibiz" → "Authenticate"
              # browser opens, sign in via WorkOS, done
/vibiz:status # confirm everything is wired up

What you get

Slash commands

Command	Does
/vibiz:status	Show the active vibiz, MCP connection state, and recent activity.
/vibiz:onboard	Create a new vibiz from the project URL or kick off onboarding for an unmatched repo.
/vibiz:post	Turn the latest commit (or a chosen diff) into a social media post draft.
/vibiz:ad	Generate a brand-aware ad creative (image + copy) from the active vibiz.
/vibiz:launch	Launch a Meta ads campaign with approved creatives and a budget.

vibiz-marketer subagent

A dedicated subagent that translates code, commits, and changelogs into on-brand marketing copy. Invoke it implicitly via the slash commands above or explicitly with @vibiz-marketer.

Auto-match — the plugin picks the right vibiz for you

On install (and at session start), the plugin reads the project's homepage URL from package.json (homepage field), then pyproject.toml, Cargo.toml, and finally the first non-badge link in README. That URL is matched against the vibizes on your account:

Exactly one match → every command silently scopes to that vibiz.
No match → the plugin offers /vibiz:onboard to create a new vibiz from the URL.
Multiple matches → you pick once and it's remembered for the project.

Post-commit nudge

After every successful git commit, the plugin suggests /vibiz:post. It skips:

Merge commits and security fixes
Conventional-commit chores: chore:, build:, ci:, style:, docs:, test:
Tiny diffs (fewer than 5 lines changed)
Commits tagged [skip-vibiz] or [no-post] in the body

Skip a single commit:

bash

git commit -m "fix: edge case" -m "[skip-vibiz]"

Manual install (no npx)

Run these inside Claude Code if npx isn't available — same outcome:

bash

/plugin marketplace add Vibiz-ai/vibiz-claude-plugin
/plugin install vibiz@vibiz
/mcp

Headless: API key

For CI or non-interactive agents that can't complete the OAuth flow, mint a static token from your workspace's Developer page on vibiz.ai and register the MCP server directly:

bash

claude mcp add --transport http vibiz https://www.vibiz.ai/api/mcp \
  --header "Authorization: Bearer YOUR_VIBIZ_API_KEY" \
  --scope user

Vibiz-ai/vibiz-claude-plugin on GitHub

After running the installer

Three small steps inside Claude Code:

bash

claude        # open Claude Code/mcp          # MCP picker → choose "vibiz" → "Authenticate"              # browser opens, sign in via WorkOS, done/vibiz:status # confirm everything is wired upclaude        # open Claude Code
/mcp          # MCP picker → choose "vibiz" → "Authenticate"
              # browser opens, sign in via WorkOS, done
/vibiz:status # confirm everything is wired up

What you get

Slash commands

Command	Does
/vibiz:status	Show the active vibiz, MCP connection state, and recent activity.
/vibiz:onboard	Create a new vibiz from the project URL or kick off onboarding for an unmatched repo.
/vibiz:post	Turn the latest commit (or a chosen diff) into a social media post draft.
/vibiz:ad	Generate a brand-aware ad creative (image + copy) from the active vibiz.
/vibiz:launch	Launch a Meta ads campaign with approved creatives and a budget.

vibiz-marketer subagent

A dedicated subagent that translates code, commits, and changelogs into on-brand marketing copy. Invoke it implicitly via the slash commands above or explicitly with @vibiz-marketer.

Auto-match — the plugin picks the right vibiz for you

Exactly one match → every command silently scopes to that vibiz.
No match → the plugin offers /vibiz:onboard to create a new vibiz from the URL.
Multiple matches → you pick once and it's remembered for the project.

Post-commit nudge

After every successful git commit, the plugin suggests /vibiz:post. It skips:

Merge commits and security fixes
Conventional-commit chores: chore:, build:, ci:, style:, docs:, test:
Tiny diffs (fewer than 5 lines changed)
Commits tagged [skip-vibiz] or [no-post] in the body

Skip a single commit:

bash

git commit -m "fix: edge case" -m "[skip-vibiz]"git commit -m "fix: edge case" -m "[skip-vibiz]"

claude mcp add --transport http vibiz https://www.vibiz.ai/api/mcp \ --header "Authorization: Bearer YOUR_VIBIZ_API_KEY" \ --scope userclaude mcp add --transport http vibiz https://www.vibiz.ai/api/mcp \ --header "Authorization: Bearer YOUR_VIBIZ_API_KEY" \ --scope user