Cursor → VibeOS
Bring Cursor-style workflows into VibeOS without installing Cursor IDE plugins. Map each idea onto an existing VibeOS socket and keep the core tool schema small.
For the full operator runbook on a real machine, see
docs/cursor-vibeos-guidebook.md in a VibeOS checkout (inventory:
docs/cursor-capabilities-adoption.md, gap plan:
docs/cursor-capabilities-gap-plan.md).
Mental model
| Cursor | VibeOS | Prefer |
|---|---|---|
| Rules | AGENTS.md / SOUL.md / user skills | Project docs + skills |
| Skills | skills/, optional-skills/, ~/.vibeos/skills/ | Skills first (zero schema cost) |
| Hooks | plugin / gateway / shell hooks | Policy + local audit |
| MCP | mcp_servers: + tools.include | Catalog install + whitelist |
| Plugins | ~/.vibeos/plugins/<name>/ with register(ctx) | Real VibeOS plugins only |
| Subagents | delegate_task / kanban / cron | Durable work → kanban |
| IDE | ACP + coding profile | scripts/run-coding-acp.sh |
| Design sidebar | skill design-to-code-loop | Tokens → patch (no IDE panel) |
| Live preview | Desktop /preview + webview rail | Loopback only |
/loop | skill session-loop + cron Monitor | No second scheduler |
| Canvas | skill analytical-ui | Runs summary / dashboard |
Do not enable TermitPro/marketplace stub dirs under plugins/ (they have
plugin.yaml but no register(ctx)). Real MCP belongs in mcp_servers:.
Shipped Cursor surface pack (C0–C12)
| Phase | Skill / artifact |
|---|---|
| C1 | pr-babysit, split-to-prs |
| C2 | cursor-subagent-cookbook |
| C3 | docs/ops/cursor-hooks-parity.md + examples/agent-hooks/ |
| C4 | session-loop |
| C5 | design-to-code-loop (template / Figma / vision) |
| C6 | desktop-local-preview + /preview + palette ports |
| C7 | analytical-ui (vibeos api runs --summary) |
| C8 | niche-mcp-kit + niche-integrations-onboarding |
| C9 | Operator closeout — sync skills + wire hooks on machine |
| C10 | cursor-review-bridge (Bugbot/Security map) |
| C11 | vibeos adoption gate (skill pack + hooks wired) |
| C12 | cursor-sdk-bridge + cursor-notebook-bridge |
Map skill: cursor-capabilities-bridge.
15-minute checklist
- Recipe? → skill (
description≤ 60 chars). - External API? →
vibeos mcp install <name>+tools.include. - Guardrail? → user plugin hook or shell hook (
examples/agent-hooks/). - Still need a tool? → plugin
ctx.register_tool(+check_fnif possible). - Core tool? → last resort (see contribution rubric in
AGENTS.md).
vibeos doctor
vibeos adoption # one-screen Cursor→VibeOS checklist
vibeos adoption sync-coding-mcp # stage disabled SaaS MCP for coding profile
vibeos adoption sync-skills --force # refresh bridge skills intentionally
vibeos adoption oauth-status # Linear/Figma/Notion token readiness (no secrets)
vibeos plugins stubs list # should be stub_count: 0 after quarantine
./scripts/smoke-cursor-adoption.sh
Install example shell hooks
mkdir -p ~/.vibeos/agent-hooks
cp examples/agent-hooks/*.sh ~/.vibeos/agent-hooks/
chmod +x ~/.vibeos/agent-hooks/*.sh
# wire hooks: from examples/agent-hooks/README.md into config.yaml
Stub quarantine
vibeos plugins stubs quarantine
vibeos plugins stubs restore <name> [--stamp …]