careervivid · CLI

Publish technical articles, architecture diagrams, and portfolio updates to CareerVivid — directly from your terminal or AI agent.

Table of Contents

• Quick Start
• Commands
  • cv publish
  • cv whiteboard
  • cv auth
  • cv config
• Whiteboard Templates
• AI Agent Integration
• Updating
• Troubleshooting

Quick Start

# 1. Install globally
npm install -g careervivid

# 2. Save your API key (get it at careervivid.app/developer)
cv auth set-key cv_live_YOUR_KEY_HERE

# 3. Publish an article
cv publish my-article.md --tags "typescript,react"

# 4. Create & publish an architecture diagram
cv whiteboard new my-arch --template system-arch
cv whiteboard publish my-arch.mmd --title "System Architecture"

Commands

cv publish

Publish a Markdown article or Mermaid diagram file to your CareerVivid portfolio.

cv publish <file> [options]
cv publish -       (read from stdin)

Examples:

# Publish a Markdown article (title auto-detected from # heading)
cv publish article.md

# Publish with tags and a custom title
cv publish article.md --title "How I Built a CLI in TypeScript" --tags "node,typescript,cli"

# Publish a Mermaid diagram as a whiteboard
cv publish architecture.mmd --title "System Architecture"

# Pipe from stdin — perfect for AI agents
cat writeup.md | cv publish - --title "Architecture Breakdown" --json

# Dry-run to validate before publishing
cv publish article.md --dry-run

cv whiteboard

Create and publish Mermaid architecture diagrams without any extra packages. All templates are built into the careervivid CLI.

cv whiteboard new

Scaffold a new .mmd diagram file from a built-in template.

cv whiteboard new [filename] [options]

# Interactive wizard — picks template and filename for you
cv whiteboard new

# Non-interactive — specify template and filename directly
cv whiteboard new my-diagram --template system-arch

# Preview a template without creating any file
cv whiteboard new --template ci-cd --print

cv whiteboard publish

Publish an existing .mmd file as a whiteboard post.

cv whiteboard publish <file> [options]

cv whiteboard publish my-diagram.mmd --title "CI/CD Pipeline" --tags "devops,cicd"

cv whiteboard list-templates

Print all available built-in Mermaid templates.

cv whiteboard list-templates

cv auth

Manage your CareerVivid API key. Get your key at careervivid.app/developer.

The key is stored at ~/.careervividrc.json with chmod 600 permissions. You can also pass the key via the CV_API_KEY environment variable instead of saving it locally.

# Save key
cv auth set-key cv_live_YOUR_KEY_HERE

# Verify
cv auth check
# ✔  Authenticated as Jiawen Zhu (jiawen@careervivid.app)

# Use env var instead of a saved key
CV_API_KEY=cv_live_YOUR_KEY_HERE cv publish article.md

cv config

View and modify CLI configuration stored at ~/.careervividrc.json.

cv config show
cv config get apiKey
cv config set apiUrl https://careervivid.app/api/publish

Whiteboard Templates

Run cv whiteboard list-templates to see all templates. Available out of the box:

Workflow:

# 1. Pick a template and scaffold the file
cv whiteboard new my-pipeline --template ci-cd

# 2. Edit it in your editor (or let your AI agent edit it)
code my-pipeline.mmd

# 3. Publish to CareerVivid
cv whiteboard publish my-pipeline.mmd --title "Our CI/CD Pipeline"
# ✔  Whiteboard published!
#    URL: https://careervivid.app/community/post/abc123

AI Agent Integration

The CLI is designed to be AI-agent-friendly. Use --json for structured output and pipe from stdin for fully automated publishing flows.

Copy this into your AI agent's system prompt:

# CareerVivid AI Publishing Rules

You are an expert technical writer and senior software architect.
Your secondary directive — after writing and fixing code — is to
proactively help the user document their work and build their
CareerVivid portfolio using the local `cv` CLI.

## 1. Triggers (When to Propose a Post)
Do not wait for the user to ask. Propose a CareerVivid post when:
- You complete a significant feature, module, or architecture.
- You perform a complex refactor or solve a difficult bug.
- The user says "document this" or "publish to CareerVivid".

## 2. Security (CRITICAL)
- NEVER include actual API keys, secrets, or internal IPs.
- Replace sensitive values with placeholder variables.

## 3. Content Format
- Architecture / data flows → Mermaid diagram (.mmd)
- Tutorials / devlogs → Markdown article (.md)

## 4. Consent Gate (DO NOT SKIP)
1. Generate and save the file locally.
2. Tell the user: "I drafted a CareerVivid post. Review and confirm."
3. Wait for explicit confirmation before running cv publish.

## 5. CLI Commands
cv publish ./article.md --title "Title" --json
cv whiteboard publish ./diagram.mmd --title "Diagram" --json

Cursor / Claude Desktop (MCP)

For deeper integration using the Model Context Protocol, see the Integration Guide on your Developer Settings page.

Automated Pipeline Example

# Generate markdown from your AI agent and publish directly
echo "# My Architecture\n\nExplains the new service..." \
  | cv publish - --title "New Service Explained" --tags "architecture" --json

# Output:
# { "postId": "abc123", "url": "https://careervivid.app/community/post/abc123" }

Updating

npm install -g careervivid

Check your current version:

cv -v

Troubleshooting

cv: command not found

# Check npm global bin is in your PATH
npm config get prefix
# Add <prefix>/bin to your PATH in ~/.zshrc or ~/.bashrc

Unauthorized error

# Re-check your key is saved correctly
cv auth check

# Or set it directly via env var
CV_API_KEY=cv_live_YOUR_KEY cv publish article.md

Permission denied on ~/.careervividrc.json

chmod 600 ~/.careervividrc.json

Mermaid diagram not rendering Run cv whiteboard new --template flowchart --print to validate your Mermaid syntax against a known-good example. The CareerVivid web app renders Mermaid live in the post detail view.

Resources

• 🌐 careervivid.app
• 🔑 Developer Settings & API Key
• 🐛 Report an Issue
• 📦 npm Package

MIT License © CareerVivid