binome 0.1.2

package/.claude/settings.local.json

@@ -0,0 +1,29 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm run *)",
+      "Bash(timeout 25 npm run start ./src)",
+      "Bash(echo \"EXIT: $?\")",
+      "Read(//tmp/**)",
+      "Bash(npx tsc *)",
+      "Bash(node -e \"console.log\\('ink', require\\('./node_modules/ink/package.json'\\).version\\); console.log\\('marked', require\\('./node_modules/marked/package.json'\\).version\\); console.log\\('marked-terminal', require\\('./node_modules/marked-terminal/package.json'\\).version\\)\")",
+      "Bash(pnpm remove *)",
+      "Bash(pnpm add *)",
+      "Bash(command -v corepack pnpm npx)",
+      "Read(//home/valentin/.local/share/pnpm/**)",
+      "Bash(corepack pnpm *)",
+      "Bash(corepack pnpm@10 remove ink-markdown)",
+      "Bash(corepack pnpm@10 add marked@^9 marked-terminal@^6)",
+      "Bash(corepack pnpm@10 add -D @types/marked-terminal@^6)",
+      "Bash(pnpm ls *)",
+      "Bash(node *)",
+      "Bash(npm view *)",
+      "Bash(echo \"tsc-exit: $?\")",
+      "Bash(command -v corepack npm npx)",
+      "Bash(PNPM_HOME=/home/valentin/.local/share/pnpm PATH=/home/valentin/.local/share/pnpm:__TRACKED_VAR__ corepack pnpm remove @types/marked-terminal)",
+      "Bash(PNPM_HOME=/home/valentin/.local/share/pnpm PATH=/home/valentin/.local/share/pnpm:__TRACKED_VAR__ corepack pnpm add marked-terminal@^7)",
+      "Bash(PNPM_HOME=/home/valentin/.local/share/pnpm PATH=/home/valentin/.local/share/pnpm:__TRACKED_VAR__ corepack pnpm install)",
+      "Bash(CI=true PNPM_HOME=/home/valentin/.local/share/pnpm PATH=/home/valentin/.local/share/pnpm:__TRACKED_VAR__ corepack pnpm install --no-frozen-lockfile)"
+    ]
+  }
+}

package/.github/workflows/npm.yml

@@ -0,0 +1,23 @@
+name: npm
+on:
+  create:
+    tags:
+      - v*
+
+jobs:
+  build:
+    name: Build and publish
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v3
+      - name: Setup Node.js environment
+        uses: actions/setup-node@v3
+        with:
+          node-version: 24
+          cache: "npm"
+          registry-url: "https://registry.npmjs.org"
+      - name: Publish
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "binome",
+  "version": "0.1.2",
+  "description": "",
+  "main": "index.js",
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "module",
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.3.177",
+    "@parcel/watcher": "^2.5.6",
+    "chalk": "^5.6.2",
+    "ink": "^7.0.6",
+    "marked": "^15.0.12",
+    "marked-terminal": "^7.3.0",
+    "react": "^19.2.7"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.3",
+    "@types/react": "^19.2.17",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "dev": "tsx --watch src/cli.tsx",
+    "start": "tsx src/cli.tsx"
+  }
+}

package/pnpm-workspace.yaml

@@ -0,0 +1,5 @@
+allowBuilds:
+  '@parcel/watcher': set this to true or false
+  esbuild: set this to true or false
+onlyBuiltDependencies:
+  - '@parcel/watcher'

package/src/Binome.tsx

@@ -0,0 +1,23 @@
+import { Box, Text } from "ink";
+import { Markdown } from "./Markdown.js";
+import { useWatcher } from "./useWatcher.js";
+
+type BinomeProps = {
+  toWatch: string;
+  sessionPurpose: string;
+};
+
+export const Binome = ({ toWatch, sessionPurpose }: BinomeProps) => {
+  const { messages } = useWatcher(toWatch, sessionPurpose);
+
+  return (
+    <Box flexDirection="column" gap={1} marginBottom={2}>
+      <Text>Watching {toWatch}</Text>
+      {messages.map((message, index) => (
+        <Markdown key={index} dim={index < messages.length - 1}>
+          {message}
+        </Markdown>
+      ))}
+    </Box>
+  );
+};

package/src/Markdown.tsx

@@ -0,0 +1,24 @@
+import { Text } from "ink";
+import { markedTerminal } from "marked-terminal";
+import { Marked } from "marked";
+import chalk from "chalk";
+
+const vivid = new Marked().use(markedTerminal());
+const dimmed = new Marked().use(
+  markedTerminal({
+    text: chalk.gray,
+    em: chalk.gray,
+    strong: chalk.gray,
+    codespan: chalk.gray,
+    code: chalk.gray,
+  }),
+);
+
+type MarkdownProps = {
+  children: string;
+  dim: boolean;
+};
+
+export const Markdown = ({ children, dim }: MarkdownProps) => (
+  <Text>{(dim ? dimmed : vivid).parse(children, { async: false }).trim()}</Text>
+);

package/src/cli.tsx

@@ -0,0 +1,13 @@
+import { render } from "ink";
+import { Binome } from "./Binome.js";
+
+const [, , folder, ...purpose] = process.argv;
+
+if (!folder) {
+  throw "You need to specify a folder to watch";
+}
+if (purpose.length === 0) {
+  throw "You need to specify the purpose of your session";
+}
+
+render(<Binome toWatch={folder} sessionPurpose={purpose.join(" ")} />);

package/src/marked-terminal.d.ts

@@ -0,0 +1,14 @@
+// marked-terminal v7 ships no types, and @types/marked-terminal (max v6) wrongly types
+// markedTerminal() as a TerminalRenderer — at runtime it returns a MarkedExtension for .use().
+// Remove this file if @types ever ships a correct v7.
+declare module "marked-terminal" {
+  import type { MarkedExtension } from "marked";
+  import type { ChalkInstance } from "chalk";
+
+  type Styler = ChalkInstance | ((text: string) => string);
+
+  export const markedTerminal: (
+    options?: Partial<Record<string, Styler>>,
+    highlightOptions?: object,
+  ) => MarkedExtension;
+}

package/src/useSession.ts

@@ -0,0 +1,105 @@
+import { CanUseTool, query } from "@anthropic-ai/claude-agent-sdk";
+import { useCallback, useEffect, useRef, useState } from "react";
+
+export const useSession = (workSubject: string) => {
+  const [readFiles, setReadFiles] = useState(new Set<string>());
+
+  const sessionId = useRef<null | string>(null);
+  const ready = useRef(false);
+
+  const [messages, setMessages] = useState<Array<string>>([]);
+
+  const canUseTool = useCallback<CanUseTool>(
+    async (toolName, input) => {
+      switch (toolName) {
+        case "Read":
+          setReadFiles(readFiles.add(input["file_path"] as string));
+          return { behavior: "allow", updatedInput: input };
+        case "Bash":
+        case "Grep":
+          return { behavior: "allow", updatedInput: input };
+        default:
+          console.error("tool not supported", toolName, input);
+          return { behavior: "deny", message: "This is not supported yet" };
+      }
+    },
+    [setReadFiles],
+  );
+
+  useEffect(() => {
+    void new Promise(async () => {
+      for await (const message of query({
+        prompt: [
+          `I am going to work on: ${workSubject}`,
+          "I will provide you with the changes as I make them",
+          "Review what I write, and point out anything you think could be improved",
+          "Try to infer my intent from the changes, and do not point out things I will most likely work on next",
+          "Do not hesitate to visit other files to better grasp the context of my task",
+          "You will keep your comments short, concise and to the point",
+          "You will not use elaborate sentences to appear eloquent, you will not compliment me",
+          'If you have nothing to comment, say "nothing to say"',
+          'Only say "nothing to say" when you have no comment at all',
+          'Do not say fillers like "Nothing else stands out"',
+          "You will not comment on issues covered by a linter, a compiler or automated tests",
+          'Do not announce what you will do, like "Let me check ..."',
+          "Reiterate what we are going to work on",
+        ].join(". "),
+        options: {
+          pathToClaudeCodeExecutable:
+            process.env["CLAUDE_CODE_PATH"] ?? "claude",
+          canUseTool,
+        },
+      })) {
+        if (message.type === "result") {
+          sessionId.current = message.session_id;
+        }
+
+        if (message.type === "assistant" && message.message?.content) {
+          for (const block of message.message.content) {
+            if ("text" in block) {
+              setMessages((messages) => messages.concat(block.text));
+              ready.current = true;
+            } else if ("name" in block) {
+              console.log(`Tool: ${block.name}`);
+            }
+          }
+        } else if (message.type === "result") {
+          console.log(`Done: ${message.subtype}`);
+        }
+      }
+    });
+  }, []);
+
+  const onFileEvent = (event: string) => (filepath: string) => {
+    const session = sessionId.current;
+
+    if (ready.current && session)
+      void new Promise(async () => {
+        for await (const message of query({
+          prompt: `This file just got ${event}: ${filepath}`,
+          options: {
+            pathToClaudeCodeExecutable:
+              process.env["CLAUDE_CODE_PATH"] ?? "claude",
+            resume: session,
+            canUseTool,
+          },
+        })) {
+          if (message.type === "assistant" && message.message?.content) {
+            for (const block of message.message.content) {
+              if ("text" in block) {
+                setMessages((messages) => messages.concat(block.text));
+              }
+            }
+          } else if (message.type === "result") {
+            console.log(`Done: ${message.subtype}`);
+          }
+        }
+      });
+  };
+
+  return {
+    messages,
+    onFileUpdated: onFileEvent("updated"),
+    onFileCreated: onFileEvent("created"),
+  };
+};

package/src/useWatcher.ts

@@ -0,0 +1,42 @@
+import watcher, { AsyncSubscription } from "@parcel/watcher";
+import { useEffect } from "react";
+import { useSession } from "./useSession.js";
+
+export const useWatcher = (folderToWatch: string, sessionPurpose: string) => {
+  const { messages, onFileUpdated, onFileCreated } = useSession(sessionPurpose);
+
+  useEffect(() => {
+    let subscription: AsyncSubscription | null = null;
+    let done = false;
+
+    watcher
+      .subscribe(folderToWatch, (_error, events) => {
+        for (const event of events) {
+          switch (event.type) {
+            case "update":
+              onFileUpdated(event.path);
+              break;
+            case "create":
+              onFileCreated(event.path);
+              break;
+          }
+        }
+      })
+      .then((sub) => {
+        if (done) {
+          sub.unsubscribe();
+        } else {
+          subscription = sub;
+        }
+      });
+
+    return () => {
+      done = true;
+      if (subscription) {
+        subscription.unsubscribe();
+      }
+    };
+  }, []);
+
+  return { messages };
+};

package/tsconfig.json

@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    "module": "node20",
+    "moduleResolution": "node16",
+    "moduleDetection": "force",
+    "target": "esnext",
+    "lib": ["DOM", "DOM.Iterable", "ES2023"],
+    "jsx": "react-jsx",
+    "declaration": true,
+    "newLine": "lf",
+    "stripInternal": true,
+    "erasableSyntaxOnly": true,
+    "strict": true,
+    "noImplicitReturns": true,
+    "noImplicitOverride": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "noUncheckedSideEffectImports": true,
+    "noEmitOnError": true,
+    "useDefineForClassFields": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}