kira-glasses-bridge 2.1.0 → 2.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kira-glasses-bridge",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "Connects your Mac to Kira, the assistant for Even G2 glasses: Claude Code sessions, files, folders and apps, by voice.",
   "type": "module",
   "bin": {

package/src/git.mjs

@@ -153,3 +153,31 @@ async function summary(before, root, files, diff, truncated, commits, treeAfter)
     truncated,
   }
 }
+
+/**
+ * Make a project folder ready: create it, then either clone the repo into it
+ * (SSH first, HTTPS as fallback) or start a fresh git repo with a README.
+ */
+export async function setupProjectFolder({ dir, name, description, sshUrl, httpsUrl }) {
+  const { mkdir, readdir, writeFile, stat } = await import('node:fs/promises')
+  const { execFile } = await import('node:child_process')
+  const run = (args, cwd) =>
+    new Promise(resolve => execFile('git', args, { cwd, maxBuffer: 8 * 1024 * 1024, timeout: 120_000 }, (err, stdout, stderr) => resolve({ ok: !err, out: String(stdout ?? ''), err: String(stderr ?? err?.message ?? '') })))
+  await mkdir(dir, { recursive: true })
+  const entries = (await readdir(dir)).filter(e => e !== '.DS_Store')
+  const already = await stat(`${dir}/.git`).then(s => s.isDirectory()).catch(() => false)
+  if (already) return { path: display(dir), existing: true, note: 'already a git repository' }
+  if (sshUrl || httpsUrl) {
+    if (entries.length) return { error: `${display(dir)} is not empty; choose an empty folder to clone into` }
+    let r = sshUrl ? await run(['clone', sshUrl, dir], dir) : { ok: false, err: 'no ssh url' }
+    if (!r.ok && httpsUrl) r = await run(['clone', httpsUrl, dir], dir)
+    if (!r.ok) return { error: `could not clone: ${r.err.trim().split('\n').pop()}` }
+    return { path: display(dir), cloned: true }
+  }
+  const r = await run(['init', '-q'], dir)
+  if (!r.ok) return { error: `git init failed: ${r.err.trim()}` }
+  if (!entries.includes('README.md')) await writeFile(`${dir}/README.md`, `# ${name ?? display(dir).split('/').pop()}\n${description ? `\n${description}\n` : ''}`)
+  await run(['add', '-A'], dir)
+  const c = await run(['commit', '-q', '-m', 'Initial commit'], dir)
+  return { path: display(dir), initialized: true, committed: c.ok, ...(c.ok ? {} : { note: 'git init done; the first commit needs git user.name and user.email configured' }) }
+}

package/src/index.mjs

@@ -3,7 +3,7 @@
 // machine on the user's behalf. Env: KIRA_BRIDGE_URL, KIRA_BRIDGE_TOKEN.
 import WebSocket from 'ws'
 import { listProjects, listSessions, readSession } from './claude-sessions.mjs'
-import { snapshot, changesSince, display } from './git.mjs'
+import { snapshot, changesSince, display, setupProjectFolder } from './git.mjs'
 import { resolveCwd } from './claude-run.mjs'
 import { agentById, AGENTS } from './agents/index.mjs'
 import { normalizeAnswer } from './agents/protocol.mjs'
@@ -118,6 +118,25 @@ const tools = {
     return tools.run_agent({ ...args, agent: 'claude' }, ws)
   },
 
+  /** A new project's folder on this Mac: created, cloned from its repo or started fresh. */
+  async setup_project_folder(args) {
+    const dir = resolveUserPath(String(args.path ?? ''))
+    return setupProjectFolder({ dir, name: args.name, description: args.description, sshUrl: args.ssh_url, httpsUrl: args.https_url })
+  },
+
+  /** Open Terminal on this Mac in a folder and run a command there (used to hand a Claude session to the person). */
+  async open_terminal(args) {
+    const dir = resolveUserPath(String(args.cwd ?? ''))
+    const command = String(args.command ?? '').replace(/[^\w\s./:@=-]/g, '')
+    if (process.platform !== 'darwin') return { error: 'opening a terminal is only supported on macOS' }
+    const { execFile } = await import('node:child_process')
+    const script = `tell application "Terminal"
+  activate
+  do script "cd ${JSON.stringify(dir)} && ${command}"
+end tell`
+    return new Promise(resolve => execFile('osascript', ['-e', script], err => resolve(err ? { error: err.message } : { opened: true, cwd: display(dir), command })))
+  },
+
   /** Read-only git facts for a folder: repo, branch, head, dirty files. */
   async git_status(args) {
     const s = await snapshot(resolveCwd(args.path ?? args.cwd))