Noah Code

Noah Code (noah-code) is a terminal coding agent for understanding repositories, planning changes, editing files, running commands, and carrying work across persistent sessions. It is built on the NVIDIA OO Agents (NOOA) runtime.

Install

Install Noah Code and its managed Python runtime with one command. No existing Python, Homebrew, or system package setup is required.

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

The bootstrapper validates macOS/Linux support, installs the standalone uv package manager, and downloads an isolated Python 3.12 runtime plus Noah Code. It does not modify a system Python.

Open a new terminal, move into a repository, and run:

noah .

Noah Code supports macOS on Apple Silicon and Intel, plus Linux on arm64 and x86_64 with Landlock and seccomp support. You also need an LLM provider account such as OpenAI, Anthropic, OpenRouter or NVIDIA.

Features

• Read files, search with ripgrep, and inspect Git status, diffs, and history.
• Edit files with anchored replacements, full rewrites, and concurrent-change detection.
• Run permission-gated shell commands with timeouts and streamed output.
• Follow repository instructions from AGENTS.md, CLAUDE.md, and .noah-code/instructions.md.
• Switch between implementation-focused build mode and read-only plan mode.
• Approve actions once or for a session with ordered allow, ask, and deny rules.
• Undo and redo journaled file edits across process restarts.
• Work in a full-screen TUI, a classic console, or one-shot non-interactive mode.
• Resume workspace-scoped sessions with todos and automatic context compaction.
• Extend workflows with slash commands, opt-in skills, MCP servers, model selection, and tracing.

Quick start

Start the TUI in the current repository and describe the desired end state in plain language:

noah .

Find the cause of the failing parser tests, implement the smallest safe fix, and run the
focused test file.

Common commands:

# Open another workspace
noah /path/to/repository

# Use the line-oriented console
noah --console .

# Run one task and exit
noah run "Explain how authentication is wired" .

# Allow actions that would normally ask; explicit deny rules still apply
noah run --auto "Fix the failing unit test" .

# Inspect and plan without editing
noah --mode plan .

# Resume work
noah --continue .
noah --session SESSION_ID .

Check the installation or inspect resolved configuration with:

noah --version
noah doctor .
noah config show .
noah update --check

The package also installs noah-code and nc as equivalent entry points. Because nc commonly refers to netcat, noah or noah-code is recommended. Keep provider API keys in the environment or trusted NOOA user configuration, never in a repository or Noah Code session metadata.

Documentation

• Interactive interface and sessions
• Configuration, modes, permissions, and updates
• Generated-code security
• Custom commands, skills, MCP, and tracing
• Development, CI, and releases

Updates

Noah Code checks PyPI for new versions at most once every 24 hours and updates uv-managed installations automatically. To check or update immediately:

noah update --check
noah update

Development

uv sync --extra dev
uv run ruff check src tests
uv run pytest tests
uv build

See the development guide for platform checks and the release process.

License

Apache-2.0, as declared in the project metadata. NOOA remains separately licensed by its upstream project.

Credits

Built on NVIDIA OO Agents (NOOA). Thanks to the NVIDIA NeMo team and NOOA contributors for the agent runtime that powers Noah Code.