noumen — the coding agent you npm install

noumen is the coding agent you npm install — the missing layer between LLMs and codebases, with pluggable providers and virtual infrastructure.

The coding agent you npm install. noumen gives you the full agentic coding loop — tool execution, file editing, shell commands, context compaction, and session management — with sandboxed virtual infrastructure that isolates your agent from the host machine. Any provider, any sandbox backend, one package.

Install

One-line install

noumen is published on npm and works with any Node.js package manager.

pnpm add noumen

Quick start

import { Code, OpenAIProvider, LocalFs, LocalComputer } from "noumen";

const code = new Code({
  aiProvider: new OpenAIProvider({ apiKey: process.env.OPENAI_API_KEY }),
  virtualFs: new LocalFs({ basePath: "/my/project" }),
  virtualComputer: new LocalComputer({ defaultCwd: "/my/project" }),
});

const thread = code.createThread();

for await (const event of thread.run("Add a health-check endpoint to server.ts")) {
  switch (event.type) {
    case "text_delta":
      process.stdout.write(event.text);
      break;
    case "tool_use_start":
      console.log(`\n[tool] ${event.toolName}`);
      break;
    case "tool_result":
      console.log(`[result] ${event.result.content.slice(0, 200)}`);
      break;
    case "turn_complete":
      console.log(`\n[tokens] ${event.usage.total_tokens} total`);
      break;
  }
}

Key features

Swap models in one line

OpenAI, Anthropic, Google Gemini. Same streaming interface, same tool dispatch. Bring your own keys.

Sandboxed by default

All tool I/O routes through VirtualFs and VirtualComputer — the sandboxing boundary. Swap in a remote container (sprites.dev) or your own Docker/E2B adapter for full isolation.