[codex] add ink shell frontend

.gitignore

@@ -6,3 +6,4 @@ dist/
 build/
 *.egg-info/
 .continuum/
+node_modules/

README.md

@@ -14,6 +14,7 @@ Local shared memory and controlled workflows for AI coding agents.
 - Optional: Ollama for local embeddings and summaries.
 - Optional: an OpenRouter API key for hosted model calls.
 - Optional: an Obsidian vault folder for readable mirrored handoffs.
+- Optional: Bun for the TypeScript/React/Ink interactive shell front end.
 
 ## Install
 
@@ -85,6 +86,11 @@ continuum shell
 continuum shell --agent gemini --color always --animation on
 ```
 
+When launched from the npm entry point in an interactive terminal, `continuum
+shell` prefers the Bun-powered TypeScript/React/Ink shell. If Bun is not
+installed, Continuum falls back to the Python shell with the same slash-command
+semantics.
+
 The shell uses slash commands and automatically scopes actions to the current
 project:
 

bin/continuum.js

@@ -9,6 +9,25 @@ const env = { ...process.env };
 env.PYTHONPATH = env.PYTHONPATH ? `${root}${path.delimiter}${env.PYTHONPATH}` : root;
 env.PYTHONDONTWRITEBYTECODE = "1";
 const forwarded = process.argv.slice(2);
+
+if (
+  forwarded[0] === "shell" &&
+  process.stdin.isTTY &&
+  process.stdout.isTTY &&
+  env.CONTINUUM_PYTHON_SHELL !== "1"
+) {
+  const shellArgs = forwarded.slice(1);
+  const bun = spawnSync("bun", ["run", path.join(root, "src", "cli.tsx"), ...shellArgs], {
+    stdio: "inherit",
+    env,
+    cwd: process.cwd(),
+  });
+  if (!bun.error || bun.error.code !== "ENOENT") {
+    process.exit(bun.status === null ? 1 : bun.status);
+  }
+  console.error("Continuum Ink shell requires Bun. Falling back to the Python shell.");
+}
+
 const candidates = process.platform === "win32"
   ? [["py", ["-3", "-m", "continuum"]], ["python", ["-m", "continuum"]]]
   : [["python3", ["-m", "continuum"]], ["python", ["-m", "continuum"]]];