VibeKit CLI

Terminal client for the VibeKit task + schedule API. Dispatch a coding task at a linked remote agent, schedule recurring cron-style jobs, check status — all from your shell. Built to compose with the rest of your dev environment.

Install

npm install -g vibekit-cli
vibekit auth

Latest published version: [email protected]. auth opens a browser OAuth flow and saves a token locally.

Commands

vibekit auth
OAuth sign-in. Stores a token in your user config directory.
vibekit account
Show the account you're signed in as + your plan.
vibekit task "<prompt>"
Send a coding task to a remote-linked agent. Returns a task ID immediately.
vibekit status <id>
Check status of a previously-submitted task.
vibekit wait <id>
Block until the task completes (or fails). Useful for shell pipelines.
vibekit tasks
List your active and recent tasks.
vibekit schedule "<prompt>" "<cron>"
Schedule a recurring task. Standard 5-field cron syntax.
vibekit schedules
List your scheduled tasks.
vibekit unschedule <id>
Cancel a scheduled task.

Useful patterns

Fire-and-wait from a shell script

id=$(vibekit task "rebuild the staging deploy snapshot for repo X" --json | jq -r .id)
vibekit wait "$id"
echo "done — see vibekit status $id for output"

Nightly cleanup via cron

vibekit schedule "delete stale branches from origin merged > 30 days ago" "0 4 * * *"

CI integration

# In a GitHub Action, after a PR merges, kick off a follow-up task on your dev box
- run: vibekit task "regenerate the SDK from openapi.yaml and commit"
  env:
    VIBEKIT_TOKEN: ${{ secrets.VIBEKIT_TOKEN }}

How this fits with the other packages

The CLI's sweet spot is shell-driven automation: scripts, cron, CI pipelines. The MCP server's sweet spot is in-editor agent workflows. Both call the same underlying API.

FAQ

What does vibekit-cli do?

It's a terminal client for the VibeKit task + schedule API. You can fire off a coding task at a linked remote agent ('refactor the auth module on machine X'), wait for it to complete, check status, or schedule it to run on a cron. Useful for automating agent workflows that don't fit into the iOS or web UI.

Does it deploy hosted apps?

For hosted-app lifecycle (create, deploy from GitHub, restart, env vars), use the MCP server or the REST API directly. The CLI is focused on task dispatch and scheduling against remote-linked agents. The two systems overlap but the CLI's sweet spot is shell-driven automation.

How do I authenticate?

Run `vibekit auth`. It opens your browser to OAuth into VibeKit and writes a token to your shell's config directory. Subsequent commands use that token until you log out.

Does this replace vibekit-agent?

No — they pair. `vibekit-agent` runs on your laptop to be a remotely-controllable worker. `vibekit-cli` is what you'd run on a *different* machine (or even the same one) to dispatch tasks at it. Common pattern: agent on dev laptop, CLI on a build server, scheduled tasks fire from the build server at the dev laptop.

Drive your agents from your shell
npm i -g vibekit-cli · vibekit auth · vibekit task "fix the 500 on /api/users"
Get an API token →