Connect your AI coding agent
in the way that suits you

The same plan, typed contracts and checks reach your agent three ways. Pick the one that fits how you build — you can switch or use more than one on the same project.

Install

$ npm install -g modular-chunks-cli

Node 18 or newer. Then run chunky login and chunky start — the guided setup scans your project, generates a plan, and hands your agent its first chunk.

How the Modular Chunks CLI works

The platform decides what to build next and writes the typed contract for it. The CLI hands that contract to your agent, then checks what comes back, so done means passed, not "the agent said so."

  1. 01Platform
    Chunk 04 · contractInstructionsTyped I/OGuardrailsEval checklist

    Plans the chunk

    Decides what to build next and writes its typed contract: instructions, typed I/O, guardrails and an eval checklist.

    chunky pull
  2. 02CLI
    $ chunky next→ Chunk 04 · Score applications$ chunky show 04→ contract copied for your agent

    Hands it to your agent

    Prints the next chunk's instructions and contract, ready for your AI coding agent to build.

    chunky next · show
  3. 03Your agent
    Claude Code · building Chunk 04src/scoring.ts · tests/scoring.test.ts

    Builds the chunk

    Claude Code, Cursor or any MCP agent writes the code, inside the files and guardrails the chunk allows.

    chunky serve
  4. 04CLI
    Typed I/O matchesGuardrails respectedTests passAcceptance criteria met4 / 4 passed

    Checks the output

    Runs what came back against the eval checklist, then syncs the result so you can approve it.

    chunky validate · sync
Passed

You approve it, and the next chunk comes up

Didn't pass

It goes back to your agent with the reason, and checks again

Command reference

46 commands, grouped by where you are in the build. Run chunky <command> --help for the live flags on any of them.

Install & account

chunky init

Set up the CLI in the current project.

chunky login

Sign in to your account.

signuplogoutwhoami
chunky config

Manage CLI config — platform URL, project ID, API token.

setshow
chunky setup

Connect a coding tool: Cursor, Copilot, Windsurf, Aider, Claude, Cline or Junie.

chunky extension

Install, build or open the Chunky VS Code extension.

Start a project

chunky start

Guided setup — scan, audit, generate blueprints and build in one flow.

chunky intake

Run the full planning pipeline: intake → brief → architecture → blueprint.

chunky upload

Bring an existing codebase onto the platform; detects your stack and generates blueprints.

Planning · scope & spec

chunky scope

Personas, journeys, and the problem ↔ solution map.

personasjourneysmapping
chunky brief

Review and refine the project brief.

chunky architecture

Review and refine the technical architecture.

alias: arch
chunky feature

Feature Builder — draft a feature and promote it into a chunk.

newlistshowrefinepromote
chunky blueprint

Manage chunk blueprints.

generatelistapprovedeleteaudit
chunky hitl

HITL questions that keep the key calls yours.

listshowanswerproduct

Delegation · build

chunky pull

Pull the latest approved chunks from the platform.

chunky status

Show every chunk and its verification status.

chunky next

Show the next chunk to build.

chunky show

Print the instructions and typed contract for a chunk.

chunky prebuild

Check a chunk against the real codebase and rewrite its instructions with actual file paths.

chunky validate

Check built output against the chunk's eval checklist.

chunky sync

Push verification results back to the platform.

chunky approve

Approve chunks from the terminal.

--all--list
chunky autopilot

Runs the build loop within a spend cap, and escalates to you when a chunk won't pass.

statusstop
chunky chunks

Manage chunks on the platform.

deleteregenerate

Verification · supervise

chunky review

Code-review guidelines and checklists.

createlistuseeditrun
chunky guideline

Engineering guidelines applied across chunks.

createlistshowuseedit
chunky playbook

Domain playbooks.

createlistshowuseedit
chunky skills

Skills attached to chunks.

listscanapply
chunky audit

Audit an existing codebase.

initpushstatusuichunkswiring
chunky log

Log a decision, or read the project activity feed.

list
chunky context

Show the active context: guideline, playbook, review, brief, architecture, chunks.

chunky debug

Turn a stuck issue into one focused instruction for your agent.

--inject

Launch

chunky launch

Turn approved chunks into a shipped product — gap analysis, deploy config, launch brief.

--tier mvp|saas|enterprise
chunky deploy

Deployment-readiness analysis for Vercel, Railway, Render, Fly or Docker.

chunky readiness

Ecosystem readiness ladders.

ecosystemstargetchecksartefactsnextcompare

Drive it from your agent

chunky serve

Start the MCP server (stdio) or an HTTP server for any agent.

--http--connect
chunky ask

Ask Chunky a question, answered with full project context.

chunky listen

Watch your clipboard for questions from your coding agent and offer to ask Chunky.

chunky tui

Open the project-aware Chunky terminal in your browser.

chunky ui

Launch a local dashboard — build status, council chat and debug.

Connect & extend

chunky recommend

Recommended services, APIs, MCPs and CLIs for your project.

servicesapismcpsclis
chunky voice

Record and transcribe, and check your quota.

recordquota
chunky roadmap

Feature roadmap — what's ready, what's blocked, and what unlocks it.

Recover

chunky resume

Rebuild session context after a crash and print a resume brief.

--from-platform
chunky checkpoint

Save a named checkpoint to the local cache for crash recovery.

chunky reset

Reset pipeline stages: brief, architecture, blueprint, session, or all.

MCP server

Structured tools for any MCP agent

Run chunky serve and any MCP-compatible agent, such as Claude Code, Cursor or Windsurf, gets the plan, typed contracts and checks as structured tools instead of copy-pasted text. Around 19 tools are registered automatically.

$ chunky serve          # MCP stdio — Claude Code, Cursor, Windsurf
$ chunky serve --http   # HTTP server for non-MCP agents

The tools your agent uses most

get_current_chunkThe current chunk spec with full context
get_session_stateRead build progress, with update_session_state to record it
ask_ctoRoute an architecture question and record the ruling
get_project_contextThe brief, architecture and active guideline

Session state is saved to .modular/cache.json, so a restarted agent picks up exactly where it left off.

Setup guide
Chrome extension

Ask Chunky, beside any tab

The Ask Chunky Chrome extension opens a side panel next to any AI coding tab: Bolt, Lovable, v0, Claude, ChatGPT, Gemini, StackBlitz and more, with 20 platforms recognised. It has your full project context through your CLI token, so you can ask "what's next?", "explain chunk 3" or "refine the brief" without leaving your work.

  • Every chunk shows as a card with a Copy button, tuned to the platform you're on: build briefs for app builders, conversational asks for chat models
  • A "Chunk 0" preamble gives your agent the venture context before the first technical chunk
  • Right-click "Ask Chunky about this" on any selected text, on any page

Install

  1. Add "Modular Chunks — Ask Chunky" from the Chrome Web Store and pin it
  2. Run chunky login, copy your token, and paste it into the extension's Settings

Private by design: it talks only to modularchunks.com, your token stays in chrome.storage.local, and it never scrapes pages.

Add to Chrome ↗Setup guide

Bring your agent
We'll onboard it

Modular Chunks is in closed beta. We review every request and onboard each user personally, so you build intentional software with AI coding agents from day one.

Request access →Command reference