Start, work, and extend VibeLink

USER GUIDE / QUICK START

설치하고 첫 작업 시작하기

VibeLink는 여러 AI 코딩 에이전트를 한 워크스페이스에서 실행하는 데스크톱 프로그램입니다. VibeLink 자체는 무료이며, 사용할 AI 서비스의 계정과 API 요금은 각 제공자의 정책을 따릅니다.

USER GUIDE / EVERYDAY WORK

프로그램의 주요 기능 사용하기

설정과 스킬

Settings에서 터미널 테마, 키 바인딩, 인터페이스 언어와 에이전트별 스킬을 조정합니다. 스킬은 에이전트가 도구를 사용하는 방법을 설명하는 지침입니다. 스킬 설치만으로 브라우저 확장 설치·계정 로그인·외부 작업 권한까지 완료되지는 않습니다.

USER GUIDE / TROUBLESHOOTING

잘 동작하지 않을 때

01 / START HERE

Choose the extension point

VibeLink has three extension points. Pick the smallest one that matches the job.

02 / MENTAL MODEL

The data flow

Agent hooks report state and completion through the narrow VibeLink CLI contract. The Chrome extension connects to the daemon over an authenticated loopback WebSocket. The daemon validates workspace, pane, and instance before updating the UI and Review.

03 / AGENT HOOKS

Build an agent hook

Desktop supports JSON hooks, drop-in TypeScript plugins, the Hermes Python plugin, and Kimi TOML. Merge into existing configuration; never overwrite a user’s hooks.

// OpenCode drop-in example
import { spawn } from 'node:child_process'

const cli = process.env.VIBELINK_CLI_EXE
const ids = ['--workspace', process.env.VIBELINK_SESSION_ID, '--pane', process.env.VIBELINK_PANE_ID, '--agent-id', 'my-agent', '--pane-instance-id', process.env.VIBELINK_PANE_INSTANCE_ID]
const reportState = (state) => cli && spawn(cli, ['terminal', 'state', ...ids, '--state', state], { detached: true, windowsHide: true }).unref()
const reportCompletion = (text) => {
  if (!cli || !text?.trim()) return
  const child = spawn(cli, ['terminal', 'complete', ...ids, '--hook-stdin'], { windowsHide: true })
  child.stdin.end(JSON.stringify({ vibelinkFinalResponse: text.trim() }))
}

export const VibeLinkCompletion = async ({ client }) => ({
  'chat.message': async () => reportState('working'),
  event: async ({ event }) => {
    if (event.type === 'permission.asked') return reportState('waiting')
    if (event.type !== 'session.idle') return
    const text = await lastAssistantText(client, event.properties.sessionID)
    reportState('idle')
    reportCompletion(text)
  },
})

지원 어댑터와 기본 위치

04 / CHROME MV3

Build a Chrome extension

Browser Control uses a Manifest V3 service worker and chrome.debugger, with one loopback WebSocket to the VibeLink daemon. It does not download and execute remote code outside the package.

{
  "manifest_version": 3,
  "name": "My VibeLink Control",
  "version": "0.1.0",
  "background": { "service_worker": "service-worker.js", "type": "module" },
  "permissions": ["debugger", "storage", "tabs"]
}

05 / LOCAL DEVELOPMENT

Install and develop locally

# 연결 상태 확인
vibelink --json status
vibelink --json browser chrome

# 확장 ID를 바꾼 뒤 pairing 초기화
vibelink browser chrome --unpair

06 / CONTRACT

State and completion contract

The visible state is working, waiting, or idle; bind is an installation action that associates a session. Completion payloads differ by agent, so read direct text first, then a transcript path, then a session id as a conservative fallback.

{
  "vibelinkFinalResponse": "에이전트가 실제로 반환한 최종 답변",
  "agent": "opencode",
  "transcript_path": "C:/…/session.jsonl"
}

직접 답변 필드 예: vibelinkFinalResponse, last_assistant_message, prompt_response, assistant_response. 경로 필드 예: transcript_path, session_id.

07 / SHIP IT

Verification checklist

08 / REFERENCES

Official references

• OpenCode 2 Plugins ↗패키지·로컬 plugin 발견, hook, publish
• OpenCode Plugins (V1) ↗V1 context와 이벤트 목록
• Chrome Manifest V3 ↗manifest.json 필드와 권한
• Manifest V3 migration ↗service worker·원격 코드 제한
• Claude Code CLI reference ↗print mode와 hook 연동 시 참고

Basis: VibeLink Desktop agent_hooks and browser-extension sources, plus official platform docs checked in September 2026.