oioxo-mcp 0.1.2 → 0.1.3

package/dist/cli/agents.d.ts

@@ -1,3 +1,5 @@
+/** The instruction files for the agents that read them at session start. */
+export declare function writeAgentInstructions(root: string): Promise<string[]>;
 export interface InitOptions {
     /** Force-write the per-PROJECT files even when not detected. */
     all?: boolean;

package/dist/cli/agents.js

@@ -123,6 +123,46 @@ async function appendToml(file, entry) {
     await fs.writeFile(file, existing + block, 'utf8');
     return true;
 }
+// ---- agent INSTRUCTION files — why OIOXO fires BEFORE the session starts ----
+// MCP registration alone leaves it to the model's judgement whether to call the
+// tool. Instructions files are read by the agent at session start, so the very
+// first prompt already routes through OIOXO. Marked block, idempotent.
+const OIOXO_START = '<!-- oioxo:start -->';
+const OIOXO_END = '<!-- oioxo:end -->';
+const OIOXO_INSTRUCTIONS = `${OIOXO_START}
+## OIOXO context engine (use it FIRST)
+This project is wired to the OIOXO MCP server. BEFORE reading, searching or listing files yourself, ALWAYS call the \`get_context\` tool from the \`oioxo\` MCP server with the task as the query — it returns the minimal relevant code slice (10-20x fewer tokens than reading files). Use \`get_impact\` before refactors, \`get_skeleton\` to learn an API cheaply, and \`remember\` to persist durable project facts.
+${OIOXO_END}`;
+/** Append/refresh the marked OIOXO block in an instructions file. */
+async function writeInstructionBlock(file) {
+    let existing = '';
+    try {
+        existing = await fs.readFile(file, 'utf8');
+    }
+    catch { /* fresh file */ }
+    const start = existing.indexOf(OIOXO_START);
+    const end = existing.indexOf(OIOXO_END);
+    let next;
+    if (start >= 0 && end > start) {
+        next = existing.slice(0, start) + OIOXO_INSTRUCTIONS + existing.slice(end + OIOXO_END.length);
+    }
+    else {
+        next = existing ? existing.trimEnd() + '\n\n' + OIOXO_INSTRUCTIONS + '\n' : OIOXO_INSTRUCTIONS + '\n';
+    }
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    await fs.writeFile(file, next, 'utf8');
+}
+/** The instruction files for the agents that read them at session start. */
+export async function writeAgentInstructions(root) {
+    const targets = [
+        path.join(root, '.github', 'copilot-instructions.md'), // Copilot reads automatically
+        path.join(root, 'CLAUDE.md'), // Claude Code reads at start
+        path.join(root, '.cursor', 'rules', 'oioxo.mdc'), // Cursor project rules
+    ];
+    for (const t of targets)
+        await writeInstructionBlock(t);
+    return targets;
+}
 export async function initAgents(root, opts = {}) {
     const home = opts.home ?? os.homedir();
     const entry = serverEntry(opts.command);
@@ -150,6 +190,9 @@ export async function initAgents(root, opts = {}) {
         console.log('  No agents detected. Run with --all to write the project configs anyway.');
         return;
     }
+    // Instruction files make agents call OIOXO from the FIRST prompt of a session.
+    await writeAgentInstructions(root);
+    console.log('  ✓ Agent instructions: .github/copilot-instructions.md, CLAUDE.md, .cursor/rules/oioxo.mdc');
     console.log('\nRestart your agent (or reload the window) and it will call OIOXO before reading files.');
     console.log('Not connected yet? Run `oioxo-mcp login`.');
 }

package/dist/test/e2e.test.js

@@ -91,6 +91,11 @@ test('init writes + merges agent configs (project + global)', async () => {
     const codex = await fs.readFile(path.join(home, '.codex', 'config.toml'), 'utf8');
     assert.ok(codex.startsWith('model = "o4"'), 'existing TOML preserved');
     assert.ok(codex.includes('[mcp_servers.oioxo]'));
+    // Instruction files (the "fires first" mechanism) — written and idempotent.
+    const copilotIns = await fs.readFile(path.join(root, '.github', 'copilot-instructions.md'), 'utf8');
+    assert.ok(copilotIns.includes('get_context'), 'copilot instructions mention the tool');
+    const claudeMd = await fs.readFile(path.join(root, 'CLAUDE.md'), 'utf8');
+    assert.ok(claudeMd.includes('oioxo:start'));
     // Idempotent: second run must not duplicate the TOML section.
     await initAgents(root, { all: true, command: 'oioxo-mcp', home });
     const codex2 = await fs.readFile(path.join(home, '.codex', 'config.toml'), 'utf8');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oioxo-mcp",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "OIOXO context engine for AI coding agents — feeds Claude Code, Copilot, Cursor and any MCP-capable agent the minimal relevant slice of your codebase, on-device, so your tokens go further.",
   "license": "SEE LICENSE IN LICENSE.md",
   "type": "module",