@usebitl/cli 0.1.0

package/README.md

@@ -0,0 +1,42 @@
+# @usebitl/cli
+
+Command-line companion for [BITL](https://usebitl.com) — stay in the loop of every AI agent you run.
+
+BITL shows what Claude Code, Codex and Antigravity are doing and where they are waiting on your call, in your PC browser and on your phone. Prompts, answers and commands are end-to-end encrypted on your PC before they leave it.
+
+## Install
+
+```sh
+npm install -g @usebitl/cli
+```
+
+Requires Node.js 20.11 or later. The command is `bitl`.
+
+## Connect
+
+```sh
+bitl login                    # once per PC — approve in the browser that opens
+bitl install claude           # Claude Code
+bitl install codex            # Codex — then trust the bitl hooks in Codex's /hooks
+bitl install antigravity      # Antigravity (agy CLI and IDE)
+```
+
+`bitl uninstall <claude|codex|antigravity>` removes only what BITL added. Run `bitl` for all commands.
+
+The hooks run small scripts copied to `~/.bitl/adapters`. They never block or slow down your agent.
+
+---
+
+## 한국어
+
+[BITL](https://usebitl.com) 을 쓰기 위한 명령줄 도구입니다. Claude Code, Codex, Antigravity 가 지금 무엇을 하는지, 어디서 내 결정을 기다리는지 PC 브라우저와 휴대폰에서 봅니다. 질문·답변·명령은 PC 에서 종단간 암호화되어 전송됩니다.
+
+```sh
+npm install -g @usebitl/cli
+bitl login                    # PC 마다 한 번 — 열리는 브라우저에서 승인
+bitl install claude           # Claude Code
+bitl install codex            # Codex — 설치 뒤 Codex 의 /hooks 에서 bitl hook 을 신뢰(trust)
+bitl install antigravity      # Antigravity (agy CLI·IDE)
+```
+
+Node.js 20.11 이상이 필요합니다. 문의: support@usebitl.com

package/adapters/bitl-agy-watch.mjs

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+// Antigravity(agy) 승인 대기 감시. bitl-hook.mjs 가 PreToolUse 마다 따로 띄운다 (agy 는 기다리지 않는다).
+//
+//   node bitl-agy-watch.mjs <PreToolUse 페이로드를 담은 임시 파일>
+//
+// agy hook 에는 승인 대기 이벤트가 없다 → 대화 DB 의 그 단계(stepIdx) 상태를 잠깐 지켜본다:
+//   승인 대기가 되면 bitl:PermissionWaiting, 승인·거부·취소되면 bitl:PermissionResolved 를 보낸다.
+//   그 전에 끝나면(대부분의 도구) 아무것도 보내지 않고 끝난다.
+// node:sqlite 가 없는 Node(22.5 미만)·DB 가 없는 환경(IDE 등)에서는 조용히 끝난다. 항상 exit 0.
+
+import { readFileSync, unlinkSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { sendRecord } from './send.mjs';
+
+const POLL_MS = 400;
+const MAX_MS = 10 * 60_000; // 승인을 이보다 오래 미루면 더 지켜보지 않는다
+const NO_STEP_MS = 15_000; // 단계가 DB 에 나타나기를 기다리는 시간
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+
+async function main() {
+  const file = process.argv[2];
+  if (!file) return;
+  let payload;
+  try {
+    payload = JSON.parse(readFileSync(file, 'utf8'));
+  } finally {
+    try {
+      unlinkSync(file);
+    } catch {
+      // 이미 없음
+    }
+  }
+  const { conversationId, stepIdx } = payload ?? {};
+  if (typeof conversationId !== 'string' || !/^[\w-]+$/.test(conversationId) || typeof stepIdx !== 'number') return;
+
+  let DatabaseSync;
+  try {
+    ({ DatabaseSync } = await import('node:sqlite'));
+  } catch {
+    return; // 오래된 Node
+  }
+  const { agyWatchStep } = await import('./dist/core.mjs');
+  const dbPath = join(homedir(), '.gemini', 'antigravity-cli', 'conversations', `${conversationId}.db`);
+
+  let db;
+  try {
+    db = new DatabaseSync(dbPath, { readOnly: true });
+  } catch {
+    return; // DB 없음 (IDE 등)
+  }
+  const query = db.prepare('SELECT status FROM steps WHERE idx = ?');
+  const send = (event) => sendRecord({ source: 'antigravity', payload: { ...payload, hook_event_name: event } });
+
+  const started = Date.now();
+  let waited = false;
+  try {
+    while (Date.now() - started < MAX_MS) {
+      let status;
+      try {
+        status = query.get(stepIdx)?.status;
+      } catch {
+        // agy 가 쓰는 중 (잠김) — 다음에 다시
+      }
+      if (status === undefined && !waited && Date.now() - started > NO_STEP_MS) return;
+      const action = agyWatchStep(status, waited);
+      if (action === 'waiting') {
+        waited = true;
+        await send('bitl:PermissionWaiting');
+      } else if (action === 'resolved') {
+        await send('bitl:PermissionResolved');
+        return;
+      } else if (action === 'stop') {
+        return;
+      }
+      await sleep(POLL_MS);
+    }
+  } finally {
+    db.close();
+  }
+}
+
+main()
+  .catch(() => {})
+  .finally(() => process.exit(0));

package/adapters/bitl-approve.mjs

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+// 원격 승인 hook (Claude Code PermissionRequest, 동기). bitl install 이 bitl-hook.mjs 와 함께 설치한다.
+//
+//   node bitl-approve.mjs [--source claude-code]   (페이로드는 stdin)
+//
+// 원격 승인이 켜졌을 때만 (보드의 "원격 승인" 스위치 또는 bitl remote on) 폰의 허용·거부를 기다린다 (기본 10분, $BITL_APPROVAL_WAIT_SEC).
+// 그 밖에는 아무것도 출력하지 않고 바로 끝나 → Claude Code 가 평소처럼 터미널에 승인 창을 띄운다.
+// 폰의 결정은 계정 키 서명을 확인한 뒤에만 따른다 (서버가 승인을 만들어 낼 수 없다). 실패는 모두 "터미널에서 승인"으로.
+import { appendFileSync, mkdirSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+const HOME = process.env.BITL_HOME?.trim() || join(homedir(), '.bitl');
+
+function log(msg) {
+  try {
+    const file = join(HOME, 'adapter-error.log');
+    try {
+      if (statSync(file).size > 1024 * 1024) return;
+    } catch {}
+    mkdirSync(HOME, { recursive: true });
+    appendFileSync(file, `${new Date().toISOString()} ${msg}\n`, 'utf8');
+  } catch {}
+}
+
+function readStdin() {
+  return new Promise((resolve) => {
+    let data = '';
+    const timer = setTimeout(() => resolve(data), 2000);
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (c) => (data += c));
+    process.stdin.on('end', () => (clearTimeout(timer), resolve(data)));
+    process.stdin.on('error', () => (clearTimeout(timer), resolve(data)));
+  });
+}
+
+const stop = new AbortController();
+for (const sig of ['SIGTERM', 'SIGINT', 'SIGHUP']) process.on(sig, () => stop.abort());
+
+async function main() {
+  const i = process.argv.indexOf('--source');
+  const source = i >= 0 ? process.argv[i + 1] : 'claude-code';
+  let payload;
+  try {
+    payload = JSON.parse(await readStdin());
+  } catch {
+    return;
+  }
+  if (payload?.hook_event_name !== 'PermissionRequest') return;
+  const { requestRemoteApproval } = await import('./dist/core.mjs');
+  const waitSec = Number(process.env.BITL_APPROVAL_WAIT_SEC);
+  const decision = await requestRemoteApproval(
+    { ...payload, source },
+    { home: HOME, waitMs: waitSec > 0 ? waitSec * 1000 : undefined, signal: stop.signal, log },
+  );
+  if (decision) process.stdout.write(JSON.stringify({ hookSpecificOutput: { hookEventName: 'PermissionRequest', decision } }));
+}
+
+main()
+  .catch((err) => log(`원격 승인: ${err?.stack ?? err}`))
+  .finally(() => process.exit(0));

package/adapters/bitl-hook.mjs

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+// 에이전트 hook/notify 페이로드를 bitl-server 로 전달한다.
+//
+//   Claude Code / Codex hooks : node bitl-hook.mjs --source claude-code|codex   (페이로드는 stdin)
+//   Codex notify              : node bitl-hook.mjs --source codex-notify        (페이로드는 마지막 argv)
+//   Antigravity hooks         : node bitl-hook.mjs --source antigravity --event PreToolUse   (이벤트 이름이 페이로드에 없다)
+//
+// 서버: $BITL_URL (기본 http://127.0.0.1:$BITL_PORT, 7777)
+// 서버가 꺼져 있으면 $BITL_HOME/queue.jsonl (기본 ~/.bitl) 에 (암호화한 채로) 쌓아두고, 서버가 시작할 때 처리한다.
+//
+// 원칙: 에이전트를 절대 방해하지 않는다 — stdout 무출력, 항상 exit 0, 짧은 타임아웃.
+// 해석(정규화)·최소화·암호화는 이 PC 에서 한다 (send.mjs → dist/core.mjs). 서버는 내용을 읽지 못한다.
+// 규칙이 바뀌면 번들만 다시 빌드하면 된다 (pnpm build). 설치 경로가 그대로라 재설치는 필요 없다.
+
+import { spawn } from 'node:child_process';
+import { writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { sendRecord } from './send.mjs';
+
+const STDIN_TIMEOUT_MS = 2000;
+
+function argValue(name) {
+  const i = process.argv.indexOf(name);
+  return i >= 0 ? process.argv[i + 1] : undefined;
+}
+
+function readStdin() {
+  return new Promise((resolve) => {
+    if (process.stdin.isTTY) return resolve('');
+    let data = '';
+    const timer = setTimeout(() => resolve(data), STDIN_TIMEOUT_MS);
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (chunk) => (data += chunk));
+    process.stdin.on('end', () => {
+      clearTimeout(timer);
+      resolve(data);
+    });
+    process.stdin.on('error', () => {
+      clearTimeout(timer);
+      resolve(data);
+    });
+  });
+}
+
+/** agy 는 승인 대기를 hook 으로 알리지 않는다 → 그 단계를 지켜볼 프로세스를 따로 띄운다 (bitl-agy-watch.mjs) */
+function watchAgyPermission(payload) {
+  try {
+    if (typeof payload.stepIdx !== 'number') return;
+    const file = join(tmpdir(), `bitl-agy-${process.pid}-${Date.now()}.json`);
+    writeFileSync(file, JSON.stringify(payload), 'utf8');
+    const script = join(import.meta.dirname, 'bitl-agy-watch.mjs');
+    spawn(process.execPath, [script, file], { detached: true, stdio: 'ignore', windowsHide: true }).unref();
+  } catch {
+    // 감시를 못 띄워도 hook 은 계속
+  }
+}
+
+async function main() {
+  const receivedAt = new Date().toISOString(); // hook 이 실행된 시각 (서버 도착 시각이 아님)
+  const source = argValue('--source') ?? 'claude-code';
+
+  const lastArg = process.argv[process.argv.length - 1];
+  const raw = lastArg?.trimStart().startsWith('{') ? lastArg : await readStdin();
+  let payload;
+  try {
+    payload = JSON.parse(raw);
+  } catch {
+    return; // 해석할 수 없는 입력은 버린다
+  }
+  // Antigravity 는 페이로드에 이벤트 이름이 없어 --event 로 받는다
+  const event = argValue('--event');
+  if (event && payload && typeof payload === 'object' && payload.hook_event_name === undefined) payload.hook_event_name = event;
+  if (source === 'antigravity' && event === 'PreToolUse') watchAgyPermission(payload);
+  await sendRecord({ source, receivedAt, payload });
+}
+
+main()
+  .catch(() => {})
+  .finally(() => process.exit(0));