internalcot - npm Package Compare versions

Comparing version 0.1.1 to 0.2.0

dist/observe-options.d.ts

+import type { ReasoningEffort } from "./model.js";
+/** Parsed options for the API-backed observation POC. */
+export type ObserveOptions = {
+    readonly model: string;
+    readonly effort: ReasoningEffort;
+    readonly maxTurns: number;
+    readonly prompt: string | undefined;
+    readonly help: boolean;
+};
+/** Parse options accepted after `internalcot observe`. */
+export declare function parseObserveOptions(args: ReadonlyArray<string>): ObserveOptions;

dist/observe-options.js

+const EFFORTS = new Set(["none", "low", "medium", "high", "xhigh", "max"]);
+function nextValue(args, index, option) {
+    const value = args[index + 1];
+    if (value === undefined) {
+        throw new Error(`${option} requires a value`);
+    }
+    return value;
+}
+/** Parse options accepted after `internalcot observe`. */
+export function parseObserveOptions(args) {
+    let model = "gpt-5.6-sol";
+    let effort = "none";
+    let maxTurns = 8;
+    let help = false;
+    const promptParts = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const argument = args[index];
+        if (argument === "--help" || argument === "-h") {
+            help = true;
+            continue;
+        }
+        if (argument === "--model" || argument === "-m") {
+            model = nextValue(args, index, argument);
+            index += 1;
+            continue;
+        }
+        if (argument === "--effort" || argument === "-e") {
+            const value = nextValue(args, index, argument);
+            if (!EFFORTS.has(value)) {
+                throw new Error(`Invalid effort: ${value}`);
+            }
+            effort = value;
+            index += 1;
+            continue;
+        }
+        if (argument === "--max-turns") {
+            const value = nextValue(args, index, argument);
+            const parsed = Number(value);
+            if (!Number.isSafeInteger(parsed) || parsed < 1) {
+                throw new Error(`Invalid max turns: ${value}`);
+            }
+            maxTurns = parsed;
+            index += 1;
+            continue;
+        }
+        if (argument?.startsWith("-")) {
+            throw new Error(`Unknown observe option: ${argument}`);
+        }
+        if (argument !== undefined) {
+            promptParts.push(argument);
+        }
+    }
+    return {
+        model,
+        effort,
+        maxTurns,
+        prompt: promptParts.length === 0 ? undefined : promptParts.join(" "),
+        help,
+    };
+}
+//# sourceMappingURL=observe-options.js.map

dist/observe-options.js.map

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

dist/setup-command.d.ts

+export declare const SETUP_USAGE = "Usage: internalcot setup [options]\n\nInstall the internalcot CLI and skill for your coding agent.\n\nOptions:\n      --codex       Install the skill for Codex\n      --claude      Install the skill for Claude Code\n      --cli-only    Install only the persistent CLI command\n      --skill-only  Install only the skill (requires an existing CLI)\n  -p, --project     Install skills in the current project instead of globally\n  -y, --yes         Accept the displayed plan without prompting\n      --dry-run     Display the plan without changing anything\n  -h, --help        Show this help\n\nNon-interactive example:\n  npx internalcot@latest setup --codex --yes";
+export declare function runSetup(args: ReadonlyArray<string>): Promise<void>;

dist/setup-command.js

+import { checkbox, confirm, select } from "@inquirer/prompts";
+import { access } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { parseSetupOptions } from "./setup-options.js";
+import { applySetup, formatSetupPlan, planSetup } from "./setup.js";
+export const SETUP_USAGE = `Usage: internalcot setup [options]
+
+Install the internalcot CLI and skill for your coding agent.
+
+Options:
+      --codex       Install the skill for Codex
+      --claude      Install the skill for Claude Code
+      --cli-only    Install only the persistent CLI command
+      --skill-only  Install only the skill (requires an existing CLI)
+  -p, --project     Install skills in the current project instead of globally
+  -y, --yes         Accept the displayed plan without prompting
+      --dry-run     Display the plan without changing anything
+  -h, --help        Show this help
+
+Non-interactive example:
+  npx internalcot@latest setup --codex --yes`;
+const promptContext = { output: process.stderr };
+export async function runSetup(args) {
+    const options = parseSetupOptions(args);
+    if (options.help) {
+        process.stdout.write(`${SETUP_USAGE}\n`);
+        return;
+    }
+    const interactive = process.stdin.isTTY && process.stderr.isTTY && !options.yes;
+    const mode = options.mode ?? (interactive ? await promptForMode() : "bundle");
+    const targets = mode === "cli-only"
+        ? []
+        : options.targets.length > 0
+            ? options.targets
+            : interactive
+                ? await promptForTargets()
+                : nonInteractiveTargetsRequired();
+    const plan = await planSetup({ mode, targets, project: options.project });
+    process.stderr.write(formatSetupPlan(plan));
+    if (options.dryRun) {
+        process.stdout.write("Dry run complete; no changes made.\n");
+        return;
+    }
+    if (interactive) {
+        const accepted = await confirm({ message: "Apply this setup plan?", default: true }, promptContext);
+        if (!accepted) {
+            process.stdout.write("Setup cancelled; no changes made.\n");
+            return;
+        }
+    }
+    const result = await applySetup(plan);
+    process.stdout.write(formatResult(result.cliInstalled, result.skillDirectories));
+}
+async function promptForMode() {
+    return select({
+        message: "What should internalcot install?",
+        choices: [
+            {
+                name: "CLI + skill (recommended)",
+                value: "bundle",
+                description: "Install the persistent command and agent instructions.",
+            },
+            {
+                name: "Skill only",
+                value: "skill-only",
+                description: "Use this when the internalcot command is already installed.",
+            },
+            {
+                name: "CLI only",
+                value: "cli-only",
+                description: "Install the command without agent instructions.",
+            },
+        ],
+    }, promptContext);
+}
+async function promptForTargets() {
+    const home = homedir();
+    const [codexDetected, claudeDetected] = await Promise.all([
+        pathExists(join(home, ".codex")),
+        pathExists(join(home, ".claude")),
+    ]);
+    while (true) {
+        const targets = await checkbox({
+            message: "Install the skill for:",
+            choices: [
+                { name: detectedLabel("Codex", codexDetected), value: "codex", checked: codexDetected },
+                { name: detectedLabel("Claude Code", claudeDetected), value: "claude", checked: claudeDetected },
+            ],
+        }, promptContext);
+        if (targets.length > 0) {
+            return targets;
+        }
+        process.stderr.write("Select at least one agent, or press Ctrl+C to cancel.\n");
+    }
+}
+function nonInteractiveTargetsRequired() {
+    throw new Error("Choose a skill target in non-interactive mode. Try --codex or --claude.");
+}
+function detectedLabel(label, detected) {
+    return detected ? `${label} (detected)` : label;
+}
+function formatResult(cliInstalled, directories) {
+    const lines = ["internalcot setup complete."];
+    if (cliInstalled) {
+        lines.push("CLI: installed");
+    }
+    for (const directory of directories) {
+        lines.push(`Skill: ${directory}`);
+    }
+    if (directories.length > 0) {
+        lines.push("Next: restart your coding agent if $internalcot is not immediately available.");
+    }
+    return `${lines.join("\n")}\n`;
+}
+async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch (cause) {
+        if (cause instanceof Error && "code" in cause && cause.code === "ENOENT") {
+            return false;
+        }
+        throw cause;
+    }
+}
+//# sourceMappingURL=setup-command.js.map

dist/setup-command.js.map

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

dist/setup-options.d.ts

+export type SetupMode = "bundle" | "cli-only" | "skill-only";
+export type SetupTarget = "codex" | "claude";
+export interface SetupOptions {
+    readonly mode: SetupMode | undefined;
+    readonly targets: ReadonlyArray<SetupTarget>;
+    readonly project: boolean;
+    readonly yes: boolean;
+    readonly dryRun: boolean;
+    readonly help: boolean;
+}
+export declare function parseSetupOptions(args: ReadonlyArray<string>): SetupOptions;

dist/setup-options.js

+export function parseSetupOptions(args) {
+    let mode;
+    const targets = [];
+    let project = false;
+    let yes = false;
+    let dryRun = false;
+    let help = false;
+    for (const arg of args) {
+        switch (arg) {
+            case "--codex":
+                addTarget(targets, "codex");
+                break;
+            case "--claude":
+                addTarget(targets, "claude");
+                break;
+            case "--cli-only":
+                mode = setMode(mode, "cli-only");
+                break;
+            case "--skill-only":
+                mode = setMode(mode, "skill-only");
+                break;
+            case "--project":
+            case "-p":
+                project = true;
+                break;
+            case "--yes":
+            case "-y":
+                yes = true;
+                break;
+            case "--dry-run":
+                dryRun = true;
+                break;
+            case "--help":
+            case "-h":
+                help = true;
+                break;
+            default:
+                throw new Error(`Unknown setup option: ${arg}`);
+        }
+    }
+    if (mode === "cli-only" && targets.length > 0) {
+        throw new Error("--cli-only cannot be combined with --codex or --claude");
+    }
+    if (mode === "cli-only" && project) {
+        throw new Error("--project has no effect with --cli-only");
+    }
+    return { mode, targets, project, yes, dryRun, help };
+}
+function addTarget(targets, target) {
+    if (!targets.includes(target)) {
+        targets.push(target);
+    }
+}
+function setMode(current, next) {
+    if (current !== undefined && current !== next) {
+        throw new Error("Choose only one of --cli-only or --skill-only");
+    }
+    return next;
+}
+//# sourceMappingURL=setup-options.js.map

dist/setup-options.js.map

+{"version":3,"file":"setup-options.js","sourceRoot":"","sources":["../src/setup-options.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,iBAAiB,CAAC,IAA2B;IAC3D,IAAI,IAA2B,CAAC;IAChC,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,IAAI,GAAG,KAAK,CAAC;IAEjB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,SAAS;gBACZ,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC5B,MAAM;YACR,KAAK,UAAU;gBACb,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAC7B,MAAM;YACR,KAAK,YAAY;gBACf,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBACjC,MAAM;YACR,KAAK,cAAc;gBACjB,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;gBACnC,MAAM;YACR,KAAK,WAAW,CAAC;YACjB,KAAK,IAAI;gBACP,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM;YACR,KAAK,OAAO,CAAC;YACb,KAAK,IAAI;gBACP,GAAG,GAAG,IAAI,CAAC;gBACX,MAAM;YACR,KAAK,WAAW;gBACd,MAAM,GAAG,IAAI,CAAC;gBACd,MAAM;YACR,KAAK,QAAQ,CAAC;YACd,KAAK,IAAI;gBACP,IAAI,GAAG,IAAI,CAAC;gBACZ,MAAM;YACR;gBACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,IAAI,IAAI,KAAK,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,IAAI,KAAK,UAAU,IAAI,OAAO,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACvD,CAAC;AAED,SAAS,SAAS,CAAC,OAA2B,EAAE,MAAmB;IACjE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,OAA8B,EAAE,IAAe;IAC9D,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

dist/setup.d.ts

+import type { SetupMode, SetupTarget } from "./setup-options.js";
+export type InstallStatus = "create" | "update" | "unchanged";
+export interface SkillInstall {
+    readonly target: SetupTarget;
+    readonly label: string;
+    readonly directory: string;
+    readonly status: InstallStatus;
+}
+export interface SetupPlan {
+    readonly mode: SetupMode;
+    readonly scope: "global" | "project";
+    readonly installCli: boolean;
+    readonly packageSpec: string;
+    readonly skills: ReadonlyArray<SkillInstall>;
+}
+export interface PlanSetupInput {
+    readonly mode: SetupMode;
+    readonly targets: ReadonlyArray<SetupTarget>;
+    readonly project: boolean;
+    readonly cwd?: string;
+    readonly home?: string;
+    readonly packageVersion?: string;
+}
+export interface ApplySetupResult {
+    readonly cliInstalled: boolean;
+    readonly skillDirectories: ReadonlyArray<string>;
+}
+export interface SetupRuntime {
+    readonly installCli?: (packageSpec: string) => Promise<void>;
+}
+export declare function planSetup(input: PlanSetupInput): Promise<SetupPlan>;
+export declare function formatSetupPlan(plan: SetupPlan): string;
+export declare function applySetup(plan: SetupPlan, runtime?: SetupRuntime): Promise<ApplySetupResult>;
+export declare function skillDirectory(target: SetupTarget, project: boolean, root: string): string;

dist/setup.js

+import { constants } from "node:fs";
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawn } from "node:child_process";
+const SKILL_FILES = ["SKILL.md", "agents/openai.yaml"];
+export async function planSetup(input) {
+    const root = input.project ? (input.cwd ?? process.cwd()) : (input.home ?? homedir());
+    const skills = input.mode === "cli-only"
+        ? []
+        : await Promise.all(input.targets.map(async (target) => {
+            const directory = skillDirectory(target, input.project, root);
+            return {
+                target,
+                label: target === "codex" ? "Codex" : "Claude Code",
+                directory,
+                status: await inspectSkill(directory),
+            };
+        }));
+    return {
+        mode: input.mode,
+        scope: input.project ? "project" : "global",
+        installCli: input.mode !== "skill-only",
+        packageSpec: `internalcot@${input.packageVersion ?? await readPackageVersion()}`,
+        skills,
+    };
+}
+export function formatSetupPlan(plan) {
+    const lines = ["Setup plan"];
+    if (plan.installCli) {
+        lines.push(`  install  CLI ${plan.packageSpec} globally`);
+    }
+    for (const skill of plan.skills) {
+        const verb = skill.status === "unchanged" ? "keep" : skill.status;
+        lines.push(`  ${verb.padEnd(7)} ${skill.label} skill at ${skill.directory}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+export async function applySetup(plan, runtime = {}) {
+    if (plan.installCli) {
+        await (runtime.installCli ?? installPersistentCli)(plan.packageSpec);
+    }
+    const installed = [];
+    for (const skill of plan.skills) {
+        if (skill.status !== "unchanged") {
+            await installSkill(skill.directory);
+        }
+        installed.push(skill.directory);
+    }
+    return { cliInstalled: plan.installCli, skillDirectories: installed };
+}
+export function skillDirectory(target, project, root) {
+    if (target === "codex") {
+        return join(root, ".agents", "skills", "internalcot");
+    }
+    return join(root, ".claude", "skills", "internalcot");
+}
+async function inspectSkill(directory) {
+    const directoryExists = await exists(directory);
+    if (!directoryExists) {
+        return "create";
+    }
+    for (const relativePath of SKILL_FILES) {
+        const [source, target] = await Promise.all([
+            readFile(join(sourceSkillDirectory(), relativePath)),
+            readFileIfPresent(join(directory, relativePath)),
+        ]);
+        if (target === undefined || !source.equals(target)) {
+            return "update";
+        }
+    }
+    return "unchanged";
+}
+async function installSkill(directory) {
+    for (const relativePath of SKILL_FILES) {
+        const target = join(directory, relativePath);
+        await mkdir(dirname(target), { recursive: true });
+        await writeFile(target, await readFile(join(sourceSkillDirectory(), relativePath)));
+    }
+}
+async function installPersistentCli(packageSpec) {
+    const executable = process.platform === "win32" ? "npm.cmd" : "npm";
+    await new Promise((resolve, reject) => {
+        const child = spawn(executable, ["install", "--global", packageSpec], {
+            stdio: "inherit",
+            shell: false,
+        });
+        child.once("error", reject);
+        child.once("exit", (code, signal) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            reject(new Error(signal === null
+                ? `npm install exited with code ${code ?? "unknown"}`
+                : `npm install was terminated by ${signal}`));
+        });
+    });
+}
+function sourceSkillDirectory() {
+    return fileURLToPath(new URL("../skills/internalcot/", import.meta.url));
+}
+async function readPackageVersion() {
+    const contents = await readFile(new URL("../package.json", import.meta.url), "utf8");
+    const value = JSON.parse(contents);
+    if (typeof value !== "object"
+        || value === null
+        || !("version" in value)
+        || typeof value.version !== "string") {
+        throw new Error("Could not read the internalcot package version");
+    }
+    return value.version;
+}
+async function exists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch (cause) {
+        if (isMissing(cause)) {
+            return false;
+        }
+        throw cause;
+    }
+}
+async function readFileIfPresent(path) {
+    try {
+        return await readFile(path);
+    }
+    catch (cause) {
+        if (isMissing(cause)) {
+            return undefined;
+        }
+        throw cause;
+    }
+}
+function isMissing(cause) {
+    return cause instanceof Error && "code" in cause && cause.code === "ENOENT";
+}
+//# sourceMappingURL=setup.js.map

dist/setup.js.map

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

dist/working-notes.d.ts

+/** Rendered streams for one observable working-note record. */
+export type WorkingNoteOutput = {
+    readonly stderr: string;
+    readonly stdout: string;
+};
+/** Result of parsing and formatting one working note. */
+export type WorkingNoteResult = {
+    readonly ok: true;
+    readonly output: WorkingNoteOutput;
+} | {
+    readonly ok: false;
+    readonly message: string;
+};
+/** Format one working note for the transcript and return a machine-readable receipt. */
+export declare function formatWorkingNote(notes: string, styled: boolean): WorkingNoteResult;

dist/working-notes.js

+const NEXT_STEP = "Continue the work. Record another note only for materially new reasoning state.";
+/** Format one working note for the transcript and return a machine-readable receipt. */
+export function formatWorkingNote(notes, styled) {
+    const normalized = notes.trim();
+    if (normalized.length === 0) {
+        return { ok: false, message: "Provide working notes as arguments or through stdin" };
+    }
+    const italic = styled ? "\u001B[3m" : "";
+    const reset = styled ? "\u001B[0m" : "";
+    return {
+        ok: true,
+        output: {
+            stderr: `${italic}internalcot> ${normalized}${reset}\n`,
+            stdout: `${JSON.stringify({ recorded: true, next: NEXT_STEP })}\n`,
+        },
+    };
+}
+//# sourceMappingURL=working-notes.js.map

dist/working-notes.js.map

+{"version":3,"file":"working-notes.js","sourceRoot":"","sources":["../src/working-notes.ts"],"names":[],"mappings":"AAAA,MAAM,SAAS,GACb,iFAAiF,CAAC;AAapF,wFAAwF;AACxF,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,MAAe;IAC9D,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,qDAAqD,EAAE,CAAC;IACvF,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACxC,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM,EAAE;YACN,MAAM,EAAE,GAAG,MAAM,gBAAgB,UAAU,GAAG,KAAK,IAAI;YACvD,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,IAAI;SACnE;KACF,CAAC;AACJ,CAAC"}

skills/internalcot/agents/openai.yaml

+interface:
+  display_name: "InternalCoT"
+  short_description: "Record visible model-authored working notes"
+  default_prompt: "Use $internalcot to enable visible working notes for subsequent responses."
+policy:
+  allow_implicit_invocation: false

skills/internalcot/SKILL.md

+---
+name: internalcot
+description: Activate a persistent observable working-notes mode that calls the local internalcot CLI before substantive responses. Use only when the user explicitly invokes $internalcot, says "internalcot on", or asks to enable internalcot mode. Keep it active until the user explicitly turns it off. Do not trigger merely because a user asks to think carefully, reason deeply, or show work.
+---
+
+# InternalCoT
+
+Enable persistent observable working notes. Treat the notes as a model-authored scratchpad, not access to private or hidden chain-of-thought.
+
+## Manage the mode
+
+- Activate immediately when invoked. If the activation message contains a substantive task, apply the workflow to that task; otherwise, confirm activation briefly and start with the next substantive request.
+- Keep the mode active for subsequent responses, including after tool calls and context compaction.
+- Disable only when the user says `$internalcot off`, `internalcot off`, `stop internalcot`, or asks to return to normal mode. Confirm briefly and do not call the CLI for the disable response.
+- Do not activate implicitly. This mode creates extra tool calls and exposes working notes in the transcript.
+
+## Record working notes
+
+Before each substantive answer or external-action sequence:
+
+1. Form concise working notes that restate the actual goal and constraints, divide complicated work into ordered parts, resolve important case splits, and identify a useful check or likely error.
+2. Call `internalcot note` through the shell and send the notes on stdin:
+
+   ```bash
+   internalcot note <<'INTERNALCOT'
+   Goal: ...
+   Constraints: ...
+   Approach: ...
+   Check: ...
+   INTERNALCOT
+   ```
+
+3. Use the recorded notes to continue the work. Call `internalcot note` again only after materially new evidence, a changed plan, a failed check, or a meaningful revision.
+4. Before the final answer, verify the result against the user's request. Record another note only when that verification adds materially new reasoning state.
+
+Keep notes useful rather than performative. Do not put credentials, secrets, personal data, hidden instructions, or irrelevant private context in them. Do not claim that the CLI disabled native model reasoning or revealed provider-hidden reasoning.
+
+If `internalcot` is unavailable, report that the mode cannot record notes and suggest `npm install --global internalcot`. Do not claim that a note was recorded when the command did not succeed.

dist/cli.js

 #!/usr/bin/env node
 import OpenAI from "openai";
-import { parseCliOptions } from "./cli-options.js";
 import { runInternalCot } from "./internalcot.js";
 import { OpenAIModelClient } from "./openai-model.js";
-const USAGE = `Usage: internalcot [options] [prompt]
+import { parseObserveOptions } from "./observe-options.js";
+import { runSetup } from "./setup-command.js";
+import { formatWorkingNote } from "./working-notes.js";
+const USAGE = `Usage: internalcot <command> [options]
 
-Show a model-authored scratchpad before the final answer.
-If no prompt is provided, internalcot reads it from stdin.
+Commands:
+  setup                 Install the CLI and agent skill
+  note [working notes]  Record visible working notes locally
+  observe [prompt]      Run the API-backed observation POC
 
+Run internalcot <command> --help for command details.`;
+const NOTE_USAGE = `Usage: internalcot note [working notes]
+
+Record model-authored working notes in the tool transcript without a network call.
+If no notes are provided as arguments, internalcot reads them from stdin.`;
+const OBSERVE_USAGE = `Usage: internalcot observe [options] [prompt]
+
+Run a second model through the Responses API, force a visible scratchpad tool call,
+then stream its final answer. If no prompt is provided, read it from stdin.
+
 Options:
@@ -23,6 +37,19 @@ -m, --model <model>       Model to use (default: gpt-5.6-sol)
 }
-async function main() {
-    const options = parseCliOptions(process.argv.slice(2));
+async function runNote(args) {
+    if (args.length === 1 && (args[0] === "--help" || args[0] === "-h")) {
+        process.stdout.write(`${NOTE_USAGE}\n`);
+        return;
+    }
+    const notes = args.length > 0 ? args.join(" ") : process.stdin.isTTY ? "" : await readStdin();
+    const result = formatWorkingNote(notes, process.stderr.isTTY);
+    if (!result.ok) {
+        throw new Error(result.message);
+    }
+    process.stderr.write(result.output.stderr);
+    process.stdout.write(result.output.stdout);
+}
+async function runObserve(args) {
+    const options = parseObserveOptions(args);
     if (options.help) {
-        process.stdout.write(`${USAGE}\n`);
+        process.stdout.write(`${OBSERVE_USAGE}\n`);
         return;
@@ -32,3 +59,3 @@ }
     if (prompt.length === 0) {
-        throw new Error("Provide a prompt as arguments or through stdin");
+        throw new Error("Provide an observation prompt as arguments or through stdin");
     }
@@ -68,3 +95,28 @@ let scratchpadStarted = false;
 }
+async function main() {
+    const [command, ...args] = process.argv.slice(2);
+    if (command === undefined || command === "--help" || command === "-h") {
+        process.stdout.write(`${USAGE}\n`);
+        return;
+    }
+    if (command === "note") {
+        await runNote(args);
+        return;
+    }
+    if (command === "setup") {
+        await runSetup(args);
+        return;
+    }
+    if (command === "observe") {
+        await runObserve(args);
+        return;
+    }
+    throw new Error(`Unknown command: ${command}`);
+}
 main().catch((cause) => {
+    if (cause instanceof Error && cause.name === "ExitPromptError") {
+        process.stderr.write("internalcot: Setup cancelled; no changes made.\n");
+        process.exitCode = 130;
+        return;
+    }
     const message = cause instanceof Error ? cause.message : String(cause);
@@ -71,0 +123,0 @@ process.stderr.write(`internalcot: ${message}\n`);

dist/cli.js.map

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

package.json

 {
   "name": "internalcot",
-  "version": "0.1.1",
-  "description": "Expose a model-authored scratchpad through a forced function call.",
+  "version": "0.2.0",
+  "description": "Visible working notes for coding agents, plus an API observation POC.",
   "license": "MIT",
@@ -18,2 +18,3 @@ "author": "morluto",
     "cli",
+    "agent-skill",
     "reasoning",
@@ -28,6 +29,7 @@ "scratchpad",
   "files": [
-    "dist"
+    "dist",
+    "skills"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "build": "node scripts/clean.mjs && tsc -p tsconfig.build.json",
     "check": "tsc -p tsconfig.json --noEmit",
@@ -42,5 +44,6 @@ "test": "vitest run",
   "engines": {
-    "node": ">=22"
+    "node": ">=22.13.0"
   },
   "dependencies": {
+    "@inquirer/prompts": "8.5.2",
     "openai": "7.4.0"
@@ -47,0 +50,0 @@ },

README.md

 # internalcot
 
-`internalcot` asks a model to put its working notes in a visible function call before answering.
-The notes are model-authored scratchpad text, not access to hidden reasoning tokens.
+`internalcot` gives coding agents a persistent, observable working-notes mode. An installed skill tells the current agent to call a small local CLI before substantive responses, so its model-authored scratchpad appears in the tool transcript.
 
-## Install
+This does not reveal private or provider-hidden chain-of-thought. It records notes that the model deliberately writes for observation.
 
+## Install the CLI and skill
+
+Run the guided setup:
+
 ```sh
+npx internalcot@latest setup
+```
+
+Choose **CLI + skill**, then select Codex, Claude Code, or both. Setup shows the exact global command and skill paths before it changes anything.
+
+For a non-interactive Codex install:
+
+```sh
+npx internalcot@latest setup --codex --yes
+```
+
+Use `--project` to place the skill in the current repository instead of your home directory. Other useful variants are:
+
+```sh
+# Preview without making changes
+npx internalcot@latest setup --codex --project --dry-run
+
+# The persistent command already exists
+npx internalcot@latest setup --codex --skill-only --yes
+
+# Install only the command
+npx internalcot@latest setup --cli-only --yes
+```
+
+Setup writes only the bundled `internalcot` skill files. Re-running it reports an unchanged installation or updates those files while preserving unrelated files in the same directory.
+
+You can also install each part manually:
+
+```sh
 npm install --global internalcot
+npx skills add morluto/internalcot
 ```
 
-Set `OPENAI_API_KEY` before running the CLI. `OPENAI_BASE_URL` can point the OpenAI SDK at a compatible gateway.
+Restart your coding agent if the new skill does not appear immediately.
 
-## Usage
+## Turn working notes on
 
+Explicitly invoke the skill without giving it a task:
+
+```text
+$internalcot
+```
+
+The mode remains active for subsequent requests. The agent calls `internalcot note` before substantive work and again only when it has materially new reasoning state.
+
+Turn it off with:
+
+```text
+$internalcot off
+```
+
+The toggle is conversational state carried by the skill instructions. It does not change the host's native reasoning setting or install a new first-class tool dynamically.
+
+## Use the working-notes CLI directly
+
+Pass a short note as arguments:
+
 ```sh
-internalcot "Solve this problem"
-cat problem.md | internalcot
-internalcot --model gpt-5.6-sol --effort none "Check this proof"
+internalcot note "Check the equality case before drafting."
 ```
 
-Scratchpad output goes to stderr; the final answer goes to stdout so it can be redirected or piped.
+For multiline notes, use stdin:
 
 ```sh
-internalcot "Check this proof" >answer.md 2>scratchpad.txt
+internalcot note <<'INTERNALCOT'
+Goal: prove descent from the equation.
+Constraint: handle every equality case.
+Check: verify the mutated coordinate stays positive.
+INTERNALCOT
 ```
 
-Run `internalcot --help` for all options.
+The note is written to stderr with an `internalcot>` prefix. Stdout receives a small JSON receipt:
 
-## How it works
+```json
+{"recorded":true,"next":"Continue the work. Record another note only for materially new reasoning state."}
+```
 
-The CLI owns the Responses API request. It sets native reasoning effort to `none` by default,
-requires an `internalcot` function call on the first turn, displays that call's arguments, and
-then returns the tool result so the model can produce its final answer.
+The command does not use the network, require an API key, or save notes to disk. The coding agent's tool transcript is the record.
 
-This does not reveal private or hidden chain-of-thought. It elicits a separate, observable
-scratchpad whose usefulness and faithfulness should be evaluated independently.
+## Run the API observation POC
 
+The separate `observe` command preserves the original experiment: it starts a second model through the OpenAI Responses API, sets its reasoning effort to `none` by default, forces an `internalcot` function call on the first turn, streams those tool arguments as a visible scratchpad, and then streams the final answer.
+
+Create a project key in the [OpenAI dashboard](https://platform.openai.com/api-keys). Never paste a key into a prompt, issue, chat, source file, or shell command that will be saved in history. Revoke and replace any exposed key.
+
+In Bash on macOS or Linux:
+
+```sh
+# Use OpenAI directly, not a previously configured compatible gateway.
+unset OPENAI_BASE_URL
+
+read -rsp "OpenAI API key: " OPENAI_API_KEY && echo
+export OPENAI_API_KEY
+
+internalcot observe --model gpt-5.6-luna \
+  "Work out 17 * 23, then give only the product."
+
+unset OPENAI_API_KEY
+```
+
+Scratchpad output goes to stderr and the final answer to stdout, so they can be captured separately:
+
+```sh
+internalcot observe "Check whether 17 * 23 = 391" \
+  >answer.txt 2>scratchpad.txt
+```
+
+The default observation model is `gpt-5.6-sol`. See the [OpenAI model catalog](https://developers.openai.com/api/docs/models) and [API quickstart](https://developers.openai.com/api/docs/quickstart).
+
+If you intentionally use an OpenAI-compatible gateway, set `OPENAI_BASE_URL` only for that gateway and use a credential issued by that provider.
+
 ## Development
@@ -49,14 +133,21 @@
 
+Validate the bundled skill with:
+
+```sh
+npx skills add . --list
+```
+
 ## Publishing
 
-The package is public and unscoped. Before the first release:
-
 ```sh
-npm login
 npm whoami
 npm run prepublishOnly
-npm pack --dry-run
+npm pack --dry-run --json
 npm publish
 ```
 
-Check that `internalcot` is still available on npm immediately before publishing.
+Verify the packed `dist/cli.js` is executable and the `skills/internalcot` directory is included before publishing.
+
+## Credit
+
+The idea and original proof of concept are by [Can Bölük (@_can1357)](https://x.com/_can1357/status/2087228354399265125).

dist/cli-options.d.ts

-import type { ReasoningEffort } from "./model.js";
-/** Parsed command-line options. */
-export type CliOptions = {
-    readonly model: string;
-    readonly effort: ReasoningEffort;
-    readonly maxTurns: number;
-    readonly prompt: string | undefined;
-    readonly help: boolean;
-};
-/** Parse the small, dependency-free internalcot command surface. */
-export declare function parseCliOptions(args: ReadonlyArray<string>): CliOptions;

dist/cli-options.js

-const EFFORTS = new Set(["none", "low", "medium", "high", "xhigh", "max"]);
-function nextValue(args, index, option) {
-    const value = args[index + 1];
-    if (value === undefined) {
-        throw new Error(`${option} requires a value`);
-    }
-    return value;
-}
-/** Parse the small, dependency-free internalcot command surface. */
-export function parseCliOptions(args) {
-    let model = "gpt-5.6-sol";
-    let effort = "none";
-    let maxTurns = 8;
-    let help = false;
-    const promptParts = [];
-    for (let index = 0; index < args.length; index += 1) {
-        const argument = args[index];
-        if (argument === "--help" || argument === "-h") {
-            help = true;
-            continue;
-        }
-        if (argument === "--model" || argument === "-m") {
-            model = nextValue(args, index, argument);
-            index += 1;
-            continue;
-        }
-        if (argument === "--effort" || argument === "-e") {
-            const value = nextValue(args, index, argument);
-            if (!EFFORTS.has(value)) {
-                throw new Error(`Invalid effort: ${value}`);
-            }
-            effort = value;
-            index += 1;
-            continue;
-        }
-        if (argument === "--max-turns") {
-            const value = nextValue(args, index, argument);
-            const parsed = Number(value);
-            if (!Number.isSafeInteger(parsed) || parsed < 1) {
-                throw new Error(`Invalid max turns: ${value}`);
-            }
-            maxTurns = parsed;
-            index += 1;
-            continue;
-        }
-        if (argument?.startsWith("-")) {
-            throw new Error(`Unknown option: ${argument}`);
-        }
-        if (argument !== undefined) {
-            promptParts.push(argument);
-        }
-    }
-    return {
-        model,
-        effort,
-        maxTurns,
-        prompt: promptParts.length === 0 ? undefined : promptParts.join(" "),
-        help,
-    };
-}
-//# sourceMappingURL=cli-options.js.map

dist/cli-options.js.map

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

New alerts

Major refactor

Supply chain risk

Package has recently undergone a major refactor. It may be unstable or indicate significant internal changes. Use caution when updating to versions that include significant changes.

Shell access

Supply chain risk

This module accesses the system shell. Accessing the system shell increases the risk of executing arbitrary code.

Filesystem access

Supply chain risk

Accesses the file system, and could potentially read sensitive data.

Found 2 instances

AI-detected potential code anomaly

Supply chain risk

AI has identified unusual behaviors that may pose a security risk.

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Fixed alerts

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Improved metrics

Total package byte prevSize

61628

145.07%

Number of package files

32

77.78%

Lines of code

802

129.8%

Number of lines in readme file

153

146.77%

Worsened metrics

Dependency count

2

100%

Number of low supply chain risk alerts

5

400%

Number of medium supply chain risk alerts

2

Infinity%

Dependency changes

• + Added

  @inquirer/prompts@8.5.2

• + Added

  @inquirer/ansi@2.0.7
  (transitive)

• + Added

  @inquirer/checkbox@5.2.3
  (transitive)

• + Added

  @inquirer/confirm@6.3.0
  (transitive)

• + Added

  @inquirer/core@12.0.1
  (transitive)

• + Added

  @inquirer/editor@5.3.1
  (transitive)

• + Added

  @inquirer/expand@5.1.3
  (transitive)

• + Added

  @inquirer/external-editor@3.0.4
  (transitive)

• + Added

  @inquirer/figures@2.0.8
  (transitive)

• + Added

  @inquirer/input@5.1.4
  (transitive)

• + Added

  @inquirer/number@4.2.1
  (transitive)

• + Added

  @inquirer/password@5.2.0
  (transitive)

• + Added

  @inquirer/prompts@8.5.2
  (transitive)

• + Added

  @inquirer/rawlist@5.3.3
  (transitive)

• + Added

  @inquirer/search@4.3.1
  (transitive)

• + Added

  @inquirer/select@5.2.3
  (transitive)

• + Added

  @inquirer/type@4.1.0
  (transitive)

• + Added

  chardet@2.2.0
  (transitive)

• + Added

  cli-width@4.1.0
  (transitive)

• + Added

  fast-string-truncated-width@3.0.3
  (transitive)

• + Added

  fast-string-width@3.0.2
  (transitive)

• + Added

  fast-wrap-ansi@0.2.2
  (transitive)

• + Added

  iconv-lite@0.7.3
  (transitive)

• + Added

  mute-stream@3.0.0
  (transitive)

• + Added

  safer-buffer@2.1.2
  (transitive)

• + Added

  signal-exit@4.1.0
  (transitive)