tmct  

Run the chat yourself

npm install -g @polycode-projects/the-mechanical-code-talker

Point it at a repo's graph and ask about the code. This runs against examples/mini-webapp, which ships in the repo:

tmct> what talks to store.mjs?
src/handlers/tasks.mjs and src/handlers/users.mjs.
tmct> which modules do not import logger?
…
tmct> /exit

Or start with nothing. tmct bootstraps an empty memory and remembers what you tell it. Use tmct chat --repo /path/to/repo to point it at your own.

tmct init         # scaffold .tmct/, tmct.toml, seed the default persona + provenance
tmct viz          # write the ledger page — see the link below
tmct syllogise    # offline: pre-derive entailed facts (a maintenance job)

A chatbot in the ELIZA/PARRY lineage, obsessed with software the way PARRY was obsessed with the mafia. Interpretation is mechanical and memory is an OWL-labelled graph on disk. It starts stocked with an everyday vocabulary. Point it at a codebase and it reasons over that too.

Use it as a library

The chat surface is a function. Feed it lines, read the answers, and the same grounding and provenance rules apply.

import { Readable } from "node:stream";
import { runChat } from "@polycode-projects/the-mechanical-code-talker";

await runChat({
  repoPath: "./my-repo",
  input: Readable.from([
    "ahab is the father of john\n",
    "who is the father of john\n",
    "/exit\n",
  ]),
  output: process.stdout,
});

Full feature list, the detailed-answer pipeline, and the rest of the library API in the README.