Nuanced – Spec-Driven AI Coding That Keeps Intent First

TL;DR

TL;DR: Nuanced is a macOS app that bridges the gap between rough intent and executed code — write a rough idea, let the agent clarify it into a structured spec, then watch Codex build while the spec stays in sync.

What Is Nuanced?

Nuanced describes itself as “the AI coding app for thinking.” The core problem it targets: agents have made code generation fast, but intent gets lost across prompts, chat transcripts, and file changes. The human mental model drifts while the codebase moves ahead.

The product page puts it plainly:

“turn rough ideas into clear specs and helps you stay connected as agents build”

Nuanced is built by Nuanced, Inc. (a private company) and is available for macOS. It currently uses Codex as the execution agent.

Setup Workflow

Step 1: Download and Install

Download the macOS app from the Nuanced releases page:

# Latest arm64 macOS download
curl -sL https://github.com/nuanced-dev/rfc-releases/releases/latest/download/Nuanced_latest_arm64.dmg

Open the .dmg and drag Nuanced into your Applications folder.

Step 2: Connect Your Accounts

On first launch, sign in with GitHub. Then connect ChatGPT (which powers Codex) to enable agent execution.

Step 3: Create a Workspace

Open the app and add a workspace with cmd+O, or use the command palette (cmd+K) to see all available actions.

Step 4: Start with Intent, Not Code

Begin a new spec by typing a rough description of what you want to build or change. The key distinction: this input is treated as raw intent, not a prompt to immediately generate code. Nuanced opens a clarification space instead of fanning out into execution.

How It Works

Spec-First Development

The spec is the center of everything in Nuanced. It is not a temporary plan buried in a chat transcript — it is the durable source of truth the agent implements against and the surface you review against as the code evolves.

Progressive Disambiguation

Before any code is written, Nuanced helps you clarify intent through an iterative process. You are not asked to define everything upfront. Instead, the system guides you through decisions around goals, constraints, invariants, and scope — one layer at a time.

Task Execution

Once the spec is clear enough, Nuanced derives tasks from it and executes them through Codex. Tasks appear in the UI as they run, keeping you informed without switching context.

Review and Commit

Generated files appear in the same interface. Review diffs and commit from within Nuanced without opening a terminal.

Source and Accuracy Notes

This section is MANDATORY. All links must be verified from actual source, not guessed.

• Project page: nuanced.dev
• Source repository: no public source repo (GitHub org: github.com/nuanced-dev — verify directly)
• License: not publicly specified (verify from vendor)
• HN launch thread: news.ycombinator.com/item?id=43345575
• Docs: docs.nuanced.dev

FAQ

Q: Is there a Windows or Linux version? A: Currently macOS only. The product page shows a macOS download button. Windows and Linux are not documented.

Q: What AI models does Nuanced use? A: Currently Codex (via ChatGPT). The launch post states this explicitly: “currently supports Codex as the execution agent.”

Q: Is the source code open source? A: Not publicly listed as open source. The GitHub org has releases but no public source repo confirmed.

Q: What does it cost? A: Pricing is not published on the product page. The launch post does not mention a tier.

Q: How does Nuanced differ from just using ChatGPT or Claude directly? A: Direct AI chat sessions treat the prompt as ephemeral. Nuanced enforces a spec-first workflow — the spec is a durable, reviewable artifact that stays in sync with the codebase as the agent works.

Conclusion

Nuanced targets a real bottleneck: the gap between fast code generation and slow human understanding. By anchoring the workflow to a living spec, it gives developers a way to steer agentic work without losing track of intent.

If you are already deep in a ChatGPT/Claude workflow and finding that code appears faster than your understanding can keep up, Nuanced’s approach is worth trying. It requires buying into the spec-first discipline, which is a workflow shift — but for larger projects where architecture and assumptions matter, that discipline pays off.