Skip to main content

bellwether link

Link current directory to a Bellwether Cloud project.

Synopsis​

bellwether link [project-id]

Description​

The link command connects your local directory to a Bellwether Cloud project. This enables automatic baseline uploads, history tracking, and verification badges.

Arguments​

ArgumentDescription
[project-id]Optional: Link to existing project ID

Examples​

bellwether link

Interactive prompt:

? Project name: my-mcp-server
? Visibility: public

Created project: my-mcp-server (proj_abc123)
Linked to current directory.
bellwether link proj_abc123

Project Configuration​

Linking creates .bellwether.json in your project root:

{
  "projectId": "proj_abc123",
  "name": "my-mcp-server"
}

This file should be committed to version control.

What Linking Enables​

After linking, you can:

  • Upload baselines with bellwether upload
  • View history with bellwether history
  • Get verification badges for your README
  • Track drift over time

Verification Badge​

After linking, add a badge to your README:

[![Bellwether](https://bellwether.sh/badge/proj_abc123)](https://bellwether.sh/projects/proj_abc123)

See Also​