v2.2 · Sandboxed Python CodeAct Agent Built on NVIDIA NOOA Runtime

The durable terminal cockpit for autonomous engineering.

Sandboxed Python CodeAct execution, parallel worktree subagents, intraline diff review, native CLAUDE.md & AGENTS.md + Claude Skills + 1-click MCPs, and -91.4% per-step prompt-cache efficiency.

curl -fsSL https://raw.githubusercontent.com/skundu42/noah-code/main/install.sh | bash
Managed standalone runtime · macOS (arm64/x64) & Linux (arm64/x64) Then run cd your-repo && noah .
Press 1–4 to switch
noah — ~/dev/payments-api — 142×38
/theme
Noah Code · ·
feat/cursor-search perm: auto sandbox: seatbelt
SUBAGENTS · 3 running · 1✓ done
you
/team build Add keyset cursor pagination to /v1/search, preserve backward compatibility for offset callers, and cover boundary cases.
noah NOOA CodeAct · AST preflight passed · brokered worker
# Fan out read-only discovery + isolated Git worktree builders in parallel
swarm = await self.task.orchestrate([
    {"agent": "explore", "prompt": "Map /v1/search SQL query & response schema"},
    {"agent": "planner", "prompt": "Verify HMAC cursor token stability on ties"},
    {
        "agent": "general",
        "prompt": "Implement cursor codec + /v1/search route in src/api/search.py",
        "isolate": True,  # Linked Git worktree from committed HEAD
    },
    {
        "agent": "general",
        "prompt": "Write tie-breaker & malformed-token tests in tests/test_search.py",
        "isolate": True,
    },
])
explore · read-only · completed (1.1s) Click any subagent pill above · F4 opens full operator ledger
✓ Read src/api/search.py, src/db/queries.py, src/schemas/pagination.py (+1) · Condensed report (620 chars): `/v1/search` sorts by `(created_at DESC, id DESC)`. Keyset cursor `(ts_ms, ulid)` avoids OFFSET scan and preserves existing `page` fallback.
✓ Checkpoint ◆ cp_94e1f0a recorded (filter-free Git plumbing · secrets excluded)
⬡ Worktree .noah-worktrees/task-api-7c2 & task-tests-9d4 active · pytest -q 18 passed
Systems Architecture

Engineered from the kernel boundary up.

Every layer in Noah Code is built for multi-hour repository work: typed Python CodeAct execution, deny-by-default OS sandboxes, isolated Git worktrees, and crash-safe transactional storage.

NVIDIA NOOA Runtime

Python CodeAct, Not Fragile JSON Tool Loops

Instead of burning 6+ LLM roundtrips on brittle JSON tool-call schemas, Noah expresses turns as persistent, typed Python cells with AST syntax preflight, exact-preimage Match anchors, and atomic multi-file apply_patch edits.

# 1 turn: parallel reads + anchored edit + immediate LSP & pytest check
src, spec = await asyncio.gather(
    self.ws.read("src/auth/tokens.py"),
    self.ws.read("tests/test_tokens.py"),
)
await self.ws.edit(
    "src/auth/tokens.py",
    Match("leeway=0", "leeway=CLOCK_SKEW_SECONDS"),  # Exact preimage check
)
check = await self.ws.bash("pytest -q tests/test_tokens.py")
Fail-Closed Containment

OS-Native Kernel Sandboxing

Generated Python cells never mount your workspace directly. They execute in a spawned worker confined by macOS Seatbelt (sandbox-exec) or Linux Landlock + seccomp, crossing a narrow permission-gated IPC broker.

Untrusted CodeAct Cell macOS Seatbelt / Landlock seccomp outbound net: DENY Direct repo mount: NONE CPU · Mem · Import limits IPC Host Permission Broker ✓ normal | auto | yolo ✕ .env / .kube / HEAD:.env Ordered allow/ask/deny Public-unicast DNS pin
Isolated Concurrency

Parallel Subagents & Linked Git Worktrees

Fan out concurrent specialists via task.orchestrate(..., isolate=True) or launch phased /team build|review|investigate workflows. Background writers get clean linked Git worktrees from HEAD while F4 gives live diff, apply, follow_up, and stop controls.

explore read-only · concurrent done 1.1s
general worktree/api-cursor diff · apply · stop
reviewer phase 3 · read-only gate queued
-91.4% Uncached Tail Tokens

Token-Efficient Prompt-Cache Architecture

Most agents mutate their system prompt on every turn (injecting timestamps, git status, or todo mutations), invalidating KV prompt caches. Noah partitions a 100% static Role.SYSTEM prefix, strips ANSI/spinner noise, and compacts stale outputs via disk-backed pointer eviction.

Naive Agent Loop (mutated system prompt + raw ANSI tail) 4,820 uncached tok / step
Noah Code v2.2 (immutable Role.SYSTEM + appended delta tail) 415 uncached tok / step (-91.4%)
✓ Static Role.SYSTEM prefix ✓ ANSI & progress stripping ✓ Pointer-eviction recall ✓ Live /tokens inspector
Drop-In Ecosystem

CLAUDE.md, AGENTS.md, Claude Skills & 1-Click MCPs

Keep your existing repository conventions untouched. Noah natively loads CLAUDE.md and AGENTS.md (with @doc.md imports and progressive subdirectory rules), discovers .claude/skills, .claude/commands, and .claude/agents, and ships 12 built-in MCP presets plus a Claude/Cursor importer.

CLAUDE.md + @imports AGENTS.md + .override .claude/skills/*/SKILL.md .claude/commands/*.md .claude/agents/*.md 12 MCP Presets + .mcp.json
Crash-Safe Persistence

Durable SQLite Sessions & Instant /resume

Terminal closed mid-run? Noah separates conversational history from host runtime state in SQLite, rolls back incomplete workspace writes via a durable file-intent journal, captures filter-free rolling Git checkpoints (◆), and lets /resume reopen your latest repo chats immediately.

1
File-Intent Journal Atomic rollback on crash
2
Git Checkpoints ◆ Shell-safe restore points
3
/resume Picker Last 3+ repo chats ready
Ergonomic Control Surface

Every workflow one keychord away.

Designed for keyboard-first speed without memorizing arcane flags. Filter Noah Code's real TUI keybindings, slash commands, and inline composer triggers below.

Provider & Protocol Agnostic

Bring your Codex account, frontier API key, or local GPU.

Configure once in /model. Keys live in Noah's owner-only 0600 auth store—never in project configs or transcripts—with configurable retries, fallback chains, and reasoning effort.

Codex / ChatGPT OAuth

No API Key Needed

Sign in directly through your browser or headless --device-code via noah providers login codex.

gpt-5.3-codex · gpt-5.2-codex · codex-max

Anthropic Direct

90%+ Prefix Cache

Route-aware prompt caching with immutable Role.SYSTEM partitioning and extended thinking support.

claude-sonnet-5.5 · claude-opus-5.5 · haiku-5.5

OpenRouter Zero-Typing

80+ Curated Routes

Full openai/*, anthropic/*, and coding flagship catalog pre-indexed in Ctrl+L before entering a key.

openrouter/auto-code · pareto-code · 2M ctx

Frontier & Open-Weight

1M Context Ready

First-class tool & CodeAct profiles across high-throughput reasoning and open-weight coding specialists.

Qwen3 Coder Next · DeepSeek V4.1 · Gemini 4 · Grok Build · Devstral · Kimi K2.7 · GLM-5.3

Local & Cloud Gateways

Air-Gapped Friendly

Live endpoint model discovery for self-hosted clusters and enterprise cloud gateways with custom headers.

Ollama · vLLM · LM Studio · NVIDIA NIM · Bedrock · Azure

HTTP Daemon & ACP v1

Editor & CI Ready

Expose the same durable host via authenticated loopback SSE streams, ACP v1 editors, or structured JSON CI runs.

noah serve · noah acp · noah run --json

Ready inside any Git repository in 10 seconds.

Install Noah Code, pick normal, auto, or yolo permissions, and start shipping.

curl -fsSL https://raw.githubusercontent.com/skundu42/noah-code/main/install.sh | bash