CLI & MCP Tools

Install the CLI and connect 24 governance tools to Claude Code.

Installation

Install the Vibe Assurance CLI globally via npm:

npm install -g @vibe-assurance/cli

Verify the installation:

vibe --version

Should output 1.0.0 or higher.

Authentication

Run the login command

vibe login

This opens your browser to the Vibe Assurance login page.

Sign in

Use your Vibe Assurance credentials or Microsoft account.

Credentials stored securely

Tokens are stored in your OS secure storage: Keychain (macOS), Credential Manager (Windows), or libsecret (Linux).

Claude Code Setup

Run the setup command

vibe setup-claude

This adds Vibe Assurance to Claude Code's MCP configuration.

Restart Claude Code

Close and reopen Claude Code. You should see "vibeassurance" listed as an active MCP server.

Verify connection

Ask Claude: "List my available vibe tools" - you should see all 24 vibe_* tools.

MCP Tools (24)

Once connected, these governance tools are available in Claude Code:

Context & Roles (5 tools)

vibe_get_context

Get governance context: CRs, risks, vulnerabilities, next CR ID

vibe_get_role

Get AI analyst role prompt by ID

vibe_list_roles

List all available AI analyst roles

vibe_create_role

Create a custom AI analyst role

vibe_update_role

Update a role's system prompt

Templates (2 tools)

vibe_get_template

Get document template by ID

vibe_list_templates

List available document templates

Artifacts (6 tools)

vibe_store_artifact

Create a new artifact (CR, RISK, VULNERABILITY, REPORT, POLICY)

vibe_update_artifact

Update artifact status or content

vibe_append_fileRecommended

Safely add a file without affecting others

vibe_list_artifacts

List artifacts with optional filters

vibe_get_artifact

Get specific artifact with all files

vibe_delete_artifact

Permanently delete an artifact

Risk Management (4 tools)

vibe_get_risk_register

Get project's risk register with filters

vibe_add_risk

Add risk with auto-calculated severity

vibe_get_risk

Get specific risk by ID

vibe_update_risk

Update risk status, treatment, or reassess

Vulnerability Management (4 tools)

vibe_get_vulnerability_register

Get project's vulnerability register

vibe_add_vulnerability

Add vulnerability with OWASP category

vibe_get_vulnerability

Get specific vulnerability by ID

vibe_update_vulnerability

Update vulnerability status or link to CR

Strategic Plans (2 tools)

vibe_get_strategic_plans

List strategic plans (REPORT artifacts)

vibe_update_plan_status

Update plan status (Draft/Active/Completed)

CLI Commands

Command	Description
`vibe login`	Authenticate via browser
`vibe logout`	Clear stored credentials
`vibe setup-claude`	Configure Claude Code's MCP settings
`vibe mcp-server`	Start the MCP server manually
`vibe projects`	List accessible projects
`vibe project current`	Show current project
`vibe project select`	Switch to different project
`vibe --version`	Show CLI version
`vibe --help`	Show help and available commands