Vibe Coding

Use the shared vibe CLI instead of repo-specific scripts.

Install

From the skill directory:

npm link

Or call directly: node scripts/vibe.js <command>.

Workflow

Run vibe setup --committer-name "..." --committer-email "..." inside the repo.
Define repo preview defaults with vibe repo init --preview-cmd ... --preview-port ....
Create a task worktree with vibe worktree create <branch> --author-name ... --author-email ....
Work inside the worktree.
Commit with vibe commit ..., never plain git commit.
Launch previews with vibe preview start.

Commands

vibe setup                          Configure repo for vibe coding
  --committer-name <name>            Bot/agent name (required on first setup)
  --committer-email <email>          Bot/agent email (required on first setup)
  --worktrees-root <path>            Base dir for worktrees (default: /root/projects/.worktrees)
  --preview-base-domain <domain>     Base domain (default: ondomain.dev)
vibe repo init                      Set preview defaults in .vibe.json
  --preview-cmd <command>             App start command (required)
  --preview-port <port>               App port (required)
  --preview-base-domain <domain>      Base domain (default: ondomain.dev)
vibe worktree create <name>         Create a new worktree
  --author-name <name>                Git author name (required)
  --author-email <email>              Git author email (required)
  --base <branch>                     Base branch (default: main)
vibe commit [git-commit-args...]    Commit with enforced author/committer
vibe preview start                  Start app + ngrok preview
  --port <port>                       Override preview port
  --cmd <command>                     Override preview command
  --base-domain <domain>              Override base domain
vibe hook pre-commit                Pre-commit hook (installed by setup)

Contract

Committer is the bot/agent doing the work — set its name and email during vibe setup.
Author is the human who directed the work — set per worktree via vibe worktree create.
Worktree metadata lives in git worktree config: vibe.worktreeName and vibe.previewSlug.
Repos declare preview defaults in .vibe.json.
Preview URL is always https://<preview-slug>.<base-domain>.

Configuration

Git config keys (set via git config):

Key	Scope	Default	Description
`vibe.committerName`	repo	— (required)	Bot/agent name
`vibe.committerEmail`	repo	— (required)	Bot/agent email
`vibe.worktreesRoot`	repo	`/root/projects/.worktrees`	Base directory for worktrees
`vibe.previewBaseDomain`	repo	`ondomain.dev`	Default preview domain
`vibe.worktreeName`	worktree	branch name	Worktree display name
`vibe.authorName`	worktree	—	Author name for commits
`vibe.authorEmail`	worktree	—	Author email for commits
`vibe.previewSlug`	worktree	slugified name	Subdomain for preview URL

Repo Manifest

Create a tracked .vibe.json file with preview defaults:

{
  "preview": {
    "command": "cd feed && bun run server.ts",
    "port": 4000,
    "baseDomain": "ondomain.dev"
  }
}

Only put repo-specific behavior in the manifest. Keep the author/committer and worktree policy in the shared CLI.

Resources

scripts/vibe.js — shared cross-repo CLI

vibe-coding