@fixy/code 0.0.0

package/README.md

@@ -0,0 +1,43 @@
+# @fixy/code
+
+Terminal REPL for Fixy Code — orchestrate installed coding agents in one conversation.
+
+## Install
+
+```sh
+npm install -g @fixy/code
+```
+
+## Usage
+
+```sh
+cd your-git-repo
+fixy
+```
+
+This opens an interactive REPL bound to a thread in the current git repository.
+
+## Talking to agents
+
+```
+fixy> @claude refactor the top of README.md for brevity
+fixy> @claude once more, even shorter
+fixy> @fixy /status
+fixy> /quit
+```
+
+- `@claude <message>` — talk to Claude Code
+- `@fixy /status` — show adapter status
+- `@fixy /worker <adapter>` — change worker model
+- `@fixy /reset` — reset thread sessions and worktrees
+- `/quit` or `/exit` — exit the REPL
+- `Ctrl-C` — cancel current turn or exit when idle
+
+## Flags
+
+- `--thread <id>` — resume an existing thread
+
+## Requirements
+
+- Node.js 20+
+- Claude Code CLI installed and logged in (`claude login`)

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { LocalThreadStore, AdapterRegistry, TurnController, WorktreeManager } from '@fixy/core';
+import { createClaudeAdapter } from '@fixy/claude-adapter';
+import { banner } from './format.js';
+import { startRepl } from './repl.js';
+async function findGitRoot(dir) {
+    let current = dir;
+    while (true) {
+        try {
+            await fs.access(path.join(current, '.git'));
+            return current;
+        }
+        catch {
+            const parent = path.dirname(current);
+            if (parent === current)
+                return null;
+            current = parent;
+        }
+    }
+}
+async function main() {
+    const gitRoot = await findGitRoot(process.cwd());
+    if (!gitRoot) {
+        process.stderr.write('Error: not inside a git repository. Run fixy from within a git project.\n');
+        process.exit(1);
+    }
+    const projectRoot = gitRoot;
+    // Parse args: --thread <id>
+    let threadId;
+    const args = process.argv.slice(2);
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--thread' && args[i + 1]) {
+            threadId = args[++i];
+        }
+    }
+    const store = new LocalThreadStore();
+    await store.init();
+    const registry = new AdapterRegistry();
+    const worktreeManager = new WorktreeManager();
+    const turnController = new TurnController();
+    registry.register(createClaudeAdapter());
+    const thread = threadId
+        ? await store.getThread(threadId, projectRoot)
+        : await store.createThread(projectRoot);
+    console.log(banner('0.0.0', registry.list().map((a) => a.id)));
+    console.log(`thread: ${thread.id}`);
+    await startRepl({ thread, store, registry, worktreeManager, turnController });
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/format.d.ts

@@ -0,0 +1,4 @@
+export declare function agentColor(agentId: string): (text: string) => string;
+export declare function formatPrefix(agentId: string): string;
+export declare function banner(version: string, adapters: string[]): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AASA,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAIpE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAIlE"}

package/dist/format.js

@@ -0,0 +1,22 @@
+const RESET = '\x1b[0m';
+const COLORS = {
+    claude: '\x1b[34m',
+    codex: '\x1b[32m',
+    fixy: '\x1b[33m',
+    system: '\x1b[2m',
+};
+export function agentColor(agentId) {
+    const code = COLORS[agentId];
+    if (!code)
+        return (text) => text;
+    return (text) => `${code}${text}${RESET}`;
+}
+export function formatPrefix(agentId) {
+    return agentColor(agentId)(`[${agentId}]`);
+}
+export function banner(version, adapters) {
+    const adapterList = adapters.map((a) => `@${a}`).join(', ');
+    const text = `fixy v${version} — ${adapterList} ready`;
+    return agentColor('fixy')(text);
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,MAAM,KAAK,GAAG,SAAS,CAAC;AAExB,MAAM,MAAM,GAA2B;IACrC,MAAM,EAAE,UAAU;IAClB,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,SAAS;CAClB,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC;IACzC,OAAO,CAAC,IAAY,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,OAAe,EAAE,QAAkB;IACxD,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,SAAS,OAAO,MAAM,WAAW,QAAQ,CAAC;IACvD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC"}

package/dist/repl.d.ts

@@ -0,0 +1,10 @@
+import type { FixyThread, LocalThreadStore, AdapterRegistry, TurnController, WorktreeManager } from '@fixy/core';
+export interface ReplParams {
+    thread: FixyThread;
+    store: LocalThreadStore;
+    registry: AdapterRegistry;
+    worktreeManager: WorktreeManager;
+    turnController: TurnController;
+}
+export declare function startRepl(params: ReplParams): Promise<void>;
+//# sourceMappingURL=repl.d.ts.map

package/dist/repl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../src/repl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,gBAAgB,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,eAAe,EAAE,eAAe,CAAC;IACjC,cAAc,EAAE,cAAc,CAAC;CAChC;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA6FjE"}

package/dist/repl.js

@@ -0,0 +1,86 @@
+import readline from 'node:readline';
+export async function startRepl(params) {
+    const { store, registry, worktreeManager, turnController } = params;
+    let thread = params.thread;
+    let turnActive = false;
+    let turnAbort = null;
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        terminal: process.stdin.isTTY ?? false,
+    });
+    // Ctrl-C: first press aborts active turn, second press (or idle) exits
+    process.on('SIGINT', () => {
+        if (turnActive && turnAbort) {
+            turnAbort.abort();
+            turnAbort = null;
+            turnActive = false;
+            process.stdout.write('\n(turn cancelled)\n');
+        }
+        else {
+            console.log('\nbye');
+            process.exit(0);
+        }
+    });
+    const ask = () => new Promise((resolve) => {
+        rl.question('fixy> ', (answer) => resolve(answer));
+        rl.once('close', () => resolve(null));
+    });
+    while (true) {
+        const line = await ask();
+        // Ctrl-D or stream closed
+        if (line === null) {
+            console.log('bye');
+            break;
+        }
+        const input = line.trim();
+        if (input.length === 0)
+            continue;
+        if (input === '/quit' || input === '/exit') {
+            console.log('bye');
+            break;
+        }
+        turnAbort = new AbortController();
+        turnActive = true;
+        try {
+            // Re-read thread from disk to get latest state
+            thread = await store.getThread(thread.id, thread.projectRoot);
+            await turnController.runTurn({
+                thread,
+                input,
+                registry,
+                store,
+                onLog: (_stream, chunk) => {
+                    process.stdout.write(chunk);
+                },
+                signal: turnAbort.signal,
+                worktreeManager,
+            });
+            // Re-read thread after turn to pick up new messages/sessions
+            thread = await store.getThread(thread.id, thread.projectRoot);
+            // Print warnings from the latest agent message
+            const lastMsg = thread.messages[thread.messages.length - 1];
+            if (lastMsg && lastMsg.warnings.length > 0) {
+                for (const w of lastMsg.warnings) {
+                    process.stderr.write(`warning: ${w}\n`);
+                }
+            }
+        }
+        catch (err) {
+            if (turnAbort.signal.aborted) {
+                // Turn was cancelled by Ctrl-C, already handled
+            }
+            else {
+                const msg = err instanceof Error ? err.message : String(err);
+                process.stderr.write(`error: ${msg}\n`);
+            }
+        }
+        finally {
+            turnActive = false;
+            turnAbort = null;
+        }
+    }
+    rl.close();
+    process.exit(0);
+}
+//# sourceMappingURL=repl.js.map

package/dist/repl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.js","sourceRoot":"","sources":["../src/repl.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@fixy/code",
+  "version": "0.0.0",
+  "type": "module",
+  "bin": {
+    "fixy": "./dist/cli.js"
+  },
+  "main": "./dist/cli.js",
+  "types": "./dist/cli.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@fixy/core": "workspace:*",
+    "@fixy/adapter-utils": "workspace:*",
+    "@fixy/claude-adapter": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0"
+  },
+  "license": "MIT"
+}

package/src/cli.ts

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { LocalThreadStore, AdapterRegistry, TurnController, WorktreeManager } from '@fixy/core';
+import { createClaudeAdapter } from '@fixy/claude-adapter';
+import { banner } from './format.js';
+import { startRepl } from './repl.js';
+
+async function findGitRoot(dir: string): Promise<string | null> {
+  let current = dir;
+  while (true) {
+    try {
+      await fs.access(path.join(current, '.git'));
+      return current;
+    } catch {
+      const parent = path.dirname(current);
+      if (parent === current) return null;
+      current = parent;
+    }
+  }
+}
+
+async function main(): Promise<void> {
+  const gitRoot = await findGitRoot(process.cwd());
+  if (!gitRoot) {
+    process.stderr.write(
+      'Error: not inside a git repository. Run fixy from within a git project.\n',
+    );
+    process.exit(1);
+  }
+  const projectRoot: string = gitRoot;
+
+  // Parse args: --thread <id>
+  let threadId: string | undefined;
+  const args = process.argv.slice(2);
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--thread' && args[i + 1]) {
+      threadId = args[++i];
+    }
+  }
+
+  const store = new LocalThreadStore();
+  await store.init();
+
+  const registry = new AdapterRegistry();
+  const worktreeManager = new WorktreeManager();
+  const turnController = new TurnController();
+
+  registry.register(createClaudeAdapter());
+
+  const thread = threadId
+    ? await store.getThread(threadId, projectRoot)
+    : await store.createThread(projectRoot);
+
+  console.log(
+    banner(
+      '0.0.0',
+      registry.list().map((a) => a.id),
+    ),
+  );
+  console.log(`thread: ${thread.id}`);
+
+  await startRepl({ thread, store, registry, worktreeManager, turnController });
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/src/format.ts

@@ -0,0 +1,24 @@
+const RESET = '\x1b[0m';
+
+const COLORS: Record<string, string> = {
+  claude: '\x1b[34m',
+  codex: '\x1b[32m',
+  fixy: '\x1b[33m',
+  system: '\x1b[2m',
+};
+
+export function agentColor(agentId: string): (text: string) => string {
+  const code = COLORS[agentId];
+  if (!code) return (text: string) => text;
+  return (text: string) => `${code}${text}${RESET}`;
+}
+
+export function formatPrefix(agentId: string): string {
+  return agentColor(agentId)(`[${agentId}]`);
+}
+
+export function banner(version: string, adapters: string[]): string {
+  const adapterList = adapters.map((a) => `@${a}`).join(', ');
+  const text = `fixy v${version} — ${adapterList} ready`;
+  return agentColor('fixy')(text);
+}

package/src/repl.ts

@@ -0,0 +1,111 @@
+import readline from 'node:readline';
+import type {
+  FixyThread,
+  LocalThreadStore,
+  AdapterRegistry,
+  TurnController,
+  WorktreeManager,
+} from '@fixy/core';
+
+export interface ReplParams {
+  thread: FixyThread;
+  store: LocalThreadStore;
+  registry: AdapterRegistry;
+  worktreeManager: WorktreeManager;
+  turnController: TurnController;
+}
+
+export async function startRepl(params: ReplParams): Promise<void> {
+  const { store, registry, worktreeManager, turnController } = params;
+  let thread = params.thread;
+
+  let turnActive = false;
+  let turnAbort: AbortController | null = null;
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    terminal: process.stdin.isTTY ?? false,
+  });
+
+  // Ctrl-C: first press aborts active turn, second press (or idle) exits
+  process.on('SIGINT', () => {
+    if (turnActive && turnAbort) {
+      turnAbort.abort();
+      turnAbort = null;
+      turnActive = false;
+      process.stdout.write('\n(turn cancelled)\n');
+    } else {
+      console.log('\nbye');
+      process.exit(0);
+    }
+  });
+
+  const ask = (): Promise<string | null> =>
+    new Promise((resolve) => {
+      rl.question('fixy> ', (answer) => resolve(answer));
+      rl.once('close', () => resolve(null));
+    });
+
+  while (true) {
+    const line = await ask();
+
+    // Ctrl-D or stream closed
+    if (line === null) {
+      console.log('bye');
+      break;
+    }
+
+    const input = line.trim();
+    if (input.length === 0) continue;
+
+    if (input === '/quit' || input === '/exit') {
+      console.log('bye');
+      break;
+    }
+
+    turnAbort = new AbortController();
+    turnActive = true;
+
+    try {
+      // Re-read thread from disk to get latest state
+      thread = await store.getThread(thread.id, thread.projectRoot);
+
+      await turnController.runTurn({
+        thread,
+        input,
+        registry,
+        store,
+        onLog: (_stream: 'stdout' | 'stderr', chunk: string) => {
+          process.stdout.write(chunk);
+        },
+        signal: turnAbort.signal,
+        worktreeManager,
+      });
+
+      // Re-read thread after turn to pick up new messages/sessions
+      thread = await store.getThread(thread.id, thread.projectRoot);
+
+      // Print warnings from the latest agent message
+      const lastMsg = thread.messages[thread.messages.length - 1];
+      if (lastMsg && lastMsg.warnings.length > 0) {
+        for (const w of lastMsg.warnings) {
+          process.stderr.write(`warning: ${w}\n`);
+        }
+      }
+    } catch (err) {
+      if (turnAbort.signal.aborted) {
+        // Turn was cancelled by Ctrl-C, already handled
+      } else {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`error: ${msg}\n`);
+      }
+    } finally {
+      turnActive = false;
+      turnAbort = null;
+    }
+  }
+
+  rl.close();
+  process.exit(0);
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src",
+    "types": ["node"]
+  },
+  "include": ["src"]
+}