vibeshare-cli

Post ShipLogs to VibeShare from your terminal in under 10 seconds.

Install

# From the cli/vibeshare-cli directory:
pnpm install
pnpm build
npm link   # makes `vibeshare` available globally

Setup

# Interactive login (stores key in ~/.vibeshare/config.json)
vibeshare login

# Or pass key directly
vibeshare login --key vbs_your_api_key_here

# Or use environment variables
export VIBESHARE_API_KEY=vbs_your_api_key_here
export VIBESHARE_API_URL=https://vibeshare.app  # optional

Usage

Post a ShipLog

# Quick post
vibeshare ship "Added dark mode to the dashboard"

# Post to a specific project
vibeshare ship -p <project-id> "Refactored auth flow"

# With a screenshot
vibeshare ship -s https://example.com/screenshot.png "New UI landed"

# With a code snippet
vibeshare ship -c "const x = 42" -l typescript "Figured out the config"

Check your streak

vibeshare streak
# Output:
# 🔥 Current streak: 5 days
#   Best streak:    12 days
#   Today:          [posted]
#   Last post:      2026-03-13

List projects

vibeshare projects

View recent shiplogs

vibeshare log
vibeshare log -n 20   # last 20 entries

Configuration

# Show current config
vibeshare config

# Set default project (auto-linked to all future posts)
vibeshare config --set-project <project-id>

# Change API URL (for self-hosted)
vibeshare config --set-url https://my-vibeshare.example.com

Config File

Stored at ~/.vibeshare/config.json with 600 permissions:

{
  "apiKey": "vbs_...",
  "apiUrl": "https://vibeshare.app",
  "defaultProjectId": "uuid-here"
}

Environment Variables

| Variable | Description | |---|---| | VIBESHARE_API_KEY | API key (overrides config file) | | VIBESHARE_API_URL | API base URL (overrides config file) |