🤲 hands for your LLM

An agent that reads, writes, and executes.

File editing, shell execution, context management, and sandboxing — any provider, any sandbox, one package.

AI Provider

Sandbox

LocalRemote

index.ts

import { Agent, AiSdkProvider } from "noumen";
import { createOpenAI } from "@ai-sdk/openai";
import { LocalSandbox } from "noumen/local";

const agent = new Agent({
  provider: new AiSdkProvider({ model: createOpenAI({ apiKey: process.env.OPENAI_API_KEY }).chat("gpt-5") }),
  sandbox: LocalSandbox({ cwd: "/my/project" }),
});

const thread = agent.createThread();
for await (const event of thread.run("Fix the auth bug")) {
  // ...
}

The agent loop is identical. Only the adapters change.

Zero config to a coding agent.

npx noumen starts an interactive agent in your terminal. No config, no signup.

noumen

>npx noumen

> Add input validation to the signup handler

[ReadFile] src/handlers/signup.ts

[EditFile] src/handlers/signup.ts +14 lines

[Bash] npm test -- signup

All 9 tests passed

turn_complete tokens: 2,847 calls: 3

Everything between the LLM and the computer

Other SDKs lock you to one model or make you build the tools yourself. Noumen ships the full stack so you ship the agent.

Seven providers, one interface

Switch models by changing one string. Same streaming, same tool dispatch.

index.ts

// swap the string — nothing else changes
const agent = LocalAgent({ provider: "anthropic", cwd: "." });

// or use any of the 7 providers:
// "openai" | "anthropic" | "gemini" | "openrouter"
// | "bedrock" | "vertex" | "ollama"

Seven sandbox backends

Swap one line to change the isolation boundary — local to cloud to SSH.

index.ts

import { Agent } from "noumen";
import { LocalSandbox } from "noumen/local";
import { SshSandbox } from "noumen/ssh";

// local development
const agent = new Agent({ provider, sandbox: LocalSandbox({ cwd: "." }) });

// production — same agent, remote sandbox over SSH
const agent = new Agent({ provider, sandbox: SshSandbox({ host: "dev.example.com", cwd: "/workspace" }) });

Nine built-in tools

The same tools inside production coding agents, wired up and ready to go.

terminal

$ npx noumen "Add input validation to signup"

  [ReadFile]   src/handlers/signup.ts
  [EditFile]   src/handlers/signup.ts  +14 lines
  [Bash]       npm test -- signup
  ✓ All 9 tests passed
  turn_complete  tokens: 2,847  cost: $0.03

Resume, compact, persist

Conversations save as JSONL. Resume any thread by ID.

resume.ts

const thread = agent.createThread({ threadId: "feature-auth" });

// picks up exactly where it left off
for await (const ev of thread.run("Continue from the last change")) {
  // ...
}

Multi-agent orchestration

Spawn isolated subagents for focused subtasks with configurable concurrency.

swarm.ts

const thread = agent.createThread();

for await (const ev of thread.run("Refactor auth and add tests")) {
  if (ev.type === "subagent_start") {
    console.log(`  spawned: ${ev.name}`); // "test-writer"
  }
}

MCP, LSP, hooks, and more

Connect external tools, query language servers, intercept everything.

config.ts

const agent = LocalAgent({
  provider: "anthropic",
  options: {
    mcpServers: {
      filesystem: { command: "npx", args: ["-y", "@mcp/server-fs", "/tmp"] },
    },
    lsp: {
      typescript: { command: "typescript-language-server", args: ["--stdio"] },
    },
  },
});

And more

Permissions Structured output Cost tracking Skills & context 18 hook events Embed anywhere Thinking

Get started in four steps.

From install to running agent in under a minute.

Install

One package. No peer dependencies.

$npm install noumen

Configure

Pick a provider and a sandbox.

configure.ts

import { Agent } from "noumen";
import { LocalSandbox } from "noumen/local";

const agent = new Agent({
  provider: "anthropic",
  sandbox: LocalSandbox({ cwd: "." }),
});

Run

Stream events from the agent loop.

run.ts

const thread = agent.createThread();

for await (const event of thread.run("Fix the auth bug")) {
  if (event.type === "text_delta") process.stdout.write(event.text);
}

Ship

Embed in your app, or run the CLI.

# zero-config interactive agent
$ npx noumen

An agent that reads, writes, and executes.

Zero config to a coding agent.

Everything between the LLM and the computer

Seven providers, one interface

Seven sandbox backends

Nine built-in tools

Resume, compact, persist

Multi-agent orchestration

MCP, LSP, hooks, and more

Get started in four steps.

Install

Configure

Run

Ship

Three imports to a coding agent.