@nac3/forge-cli weekly downloads statistics

Yujin Forge

A voice-first NAC-3 development framework + build tool. Forge gives a developer (or an institution like ADIP teaching kids to code) a single CLI + chat panel that covers the full app-creation loop: read design specs by voice, generate code scaffolds from those specs, decorate vanilla HTML into NAC-3, drive existing apps via voice + chat.

Status: v1.0.51 (2026-06-28). Published on npm as @nac3/forge-cli (tag latest). 100% manifest verb coverage: every one of the 119 declared NAC-3 verbs has at least one fake-scripted scenario asserting it gets invoked (or refuses to) in the right intent. 56 top-level CLI commands (see the full list below). Brain matrix QA harness + 8 helper CLIs under yf qa; ops docs (SECURITY, CONTRIBUTING, TESTING_GUIDE, DEPLOYMENT, CI_PIPELINE); structural fixture validator + pre-commit gate. The MCP bridge config + office.* + a11y.* verbs shipped; brain federation (parent/child) shipped; the agent orchestrator surface (yf agent) shipped; multi-agent session orchestration (yujin.session.*, opt-in, default OFF) shipped 2026-06-28.

HITO 0 -- credentials vault. AES-256-GCM at-rest encryption with machine fingerprint binding, atomic writes (0o600), one-shot reveal, vault modal in chat panel. Slots: anthropic / openai / google_voice / elevenlabs / github_token.

HITO 1 -- voice + reader + spec ingest. Bidirectional voice (Whisper + Google STT, ElevenLabs + Google TTS) with chunked pipelined playback (~600 ms first audio on long sections). Voiceprint enrolment + 5-layer trust model + liveness challenge on irreversible ops. Document reader for txt / md / source / html / rtf / csv / epub / pdf / docx / xlsx (10 formats) with voice- driven navigation (open / next / search / bookmark / recap). Spec drag-drop: drop a PDF/DOCX/etc into chat -> Forge parses -> Claude extracts requirements/entities/endpoints/components -> generates a file plan -> writes the scaffold after explicit approval -> rollback on demand.

Fase F -- 10-language i18n + manuals. Panel UI + voice intent matcher + HTML user manuals all available in es / en / pt / fr / ja / zh / hi / ar / de / it. Globe button in the chat panel swaps the active language; the new forge.manual.open tool routes "abrime el manual" / "open the manual" / "マニュアルを開いて" / etc to the right HTML manual served through the reader pipeline. Catalog-lint refuses to publish if any locale is missing keys.

Earlier work still shipping: G1 (AST migrator robustness) + G2 (LLM retry loop) + G3 (multi-page HTML) + G4 (--dry-run for ai modes) + G5 (SPEC sync) + G6 (Figma scaffolder alpha) + the v0.3.0 chat tool-use loop (forge.read_manifest, forge.consult_nac_spec, plus the V1.11..V1.13 github/git/ lifecycle tools and the V1.28 + V1.32 reader tools).

Full vitest suite green (~3800 cases across ~350 suites, Linux + macOS + Windows CI). AI decorator validated on calc fixture (15/15 dispatch tasks OK) + Conduit-NAC3 (178/180 cross-lang at N=3). See yujin.app/nac-spec/migration/ for the migration paper, docs/HITO_1_ARCHITECTURE.md for the voice+reader internals, and docs/EVOLUTION_PLAN.md for what is next.

What it is

Four things in one:

1. An AI-powered NAC-3 decorator. yf migrate <dir> --ai-silent calls Claude Sonnet 4.6 with the HTML + JS source, gets back a fully-decorated HTML + JSON manifest, post-processes the output to bake in the NAC3 runtime + contract bridge + inline NAC.register. Takes ~25 s and ~$0.05 per app.

2. A Pilot installer. yf pilot install <dir> injects the embedded chat + voice + multi-model bundle into any Forge-decorated app. The same UI works against any NAC-3-compliant page, regardless of how it was decorated.

3. A React/AST migration scaffold (planned). yf migrate <existing-react-repo> audits the codebase, proposes the migration path screen-by-screen, executes the diff. The audit + apply flow is in place; the React-specific AST migrator is in flight.

4. A voice-first developer assistant (HITO 1). yf chat launches a local panel with bidirectional voice, a 10-format document reader, and drag-drop spec ingest. Drop a PDF / DOCX / HTML spec into chat -> Forge extracts requirements via Claude -> generates a file scaffold plan -> writes the project after you approve. Reverse the scaffold with one click. Aimed at solo developers + institutional teams (ADIP) who want the full "read spec out loud, then write the code" cycle without leaving the keyboard or the headset. See "Voice cockpit + spec ingest" below.

Quick start

# Install
npm install -g @nac3/forge-cli@latest

# Guided first run: activates your license (auto-synced) + sets your
# AI key (BYOK). One command, it walks you through the rest.
yf onboard

# Decorate a vanilla HTML app (one shot, no human input)
yf migrate ./my-app --ai-silent --ai-out ./my-app-decorated

# Same, but include Yujin Pilot (needs the separate Pilot bundle --
# see "How Pilot works"; not shipped in this repo or the npm package)
yf migrate ./my-app --ai-silent --with-pilot --ai-out ./my-app-decorated

# Install Pilot into an already-decorated app (needs the Pilot bundle)
yf pilot install ./my-app-decorated

# Open it
xdg-open ./my-app-decorated/index.html

The decorated output is drop-in NAC3-ready: no CDN dependencies at runtime, the manifest is registered inline at boot, every action button is wired through NAC.bindAction, the floating Pilot button appears bottom-right. Click it, paste an API key, and drive the page by voice or text.…