navig-text

AI text generation (drafts/articles/captions/briefs) + navig design (agent HTML/CSS restyle + design tokens) for the Design Mode lens.

Works on its own — its own CLI, no navig required · v0.5.1 · PyPI

On its own (no navig needed)

pip install navig-text
navig-text --help   # no navig needed

With navig

pip install navig-text
navig text --help

AI text generation for NAVIG — drafts, articles, captions, and fan-out briefs. A first-party, free, toggleable plugin, and the TEXT facet of NAVIG's shared media-generation engine.

navig text gen "explain vector databases in 5 bullets"          # a quick draft
navig text gen "NAVIG weekly update" --kind article --out ./out # a full article
navig text gen "ship faster with NAVIG" --kind caption          # one caption
navig text gen "NAVIG v2 launch" --kind brief                   # a fan-out brief
navig text check                                                # is a provider ready?

navig text lyrics — lyrics that sit on a beat

No AI and no network — it reads your files. A beat's bar map comes from its JSON sidecar (measured.bars, written by navig audio beat gen); navig-audio is only needed to measure a beat that has none.

navig text lyrics scaffold beat.json --lang ru,en,fr -o draft.md   # empty text cut to the measured bar map
navig text lyrics fit draft.md --bpm 88                            # syllables per line vs the bar
navig text lyrics fit --all lyrics/ --beats beats/ --report FIT.md # every text + its nearest beat
navig text lyrics words "hood" --bank lyrics/dictionary            # word-bank entries that mention it
navig text lyrics rhyme night --in lyrics/                         # rhymes from words you already use
navig text lyrics sheet draft.md --beat beat.mp3 --lang fr --start-bar 25 -o demo.yaml

• scaffold maps each measured block to a section — build → intro, drop/mid → hook, full → 16-line verses (the rest a hook, or a pre-hook pickup), tail → outro — and writes one _ slot per line with the syllables it can carry. fit never counts a _ line.
• fit counts syllables (Russian by vowel, English/French by vowel group) against the time one bar gives — about 3.2–5.1 a second — and lists the lines to split, fill or keep as a punch. navig audio beat fit is an alias.
• sheet turns a text's first hook and its voices table (## Voices / ## Голоса …: line numbers → a voice per language) into a sheet for navig audio beat demo.
• rhyme matches spelling, not sound: strong = same tail from the second-to-last vowel, weak = same last vowel and what follows (plus the consonant before an open final vowel).

navig design — the Design Mode surface

The agent-backed surface behind the Design Mode browser lens (in the NAVIG Dock extension). Same core AI client as text generation — code/markup is text, so it lives here rather than in a separate plugin.

navig design edit --prompt "make this a bold dark CTA" --html '<button>Buy</button>'
navig design check                                    # is an AI provider ready?
navig design tokens show                              # the global design system
navig design tokens show --space acme                 # a space's design system

• design edit returns the revised element HTML as JSON on stdout; the lens base64-encodes the element + your instruction, calls it via host.run(), then applies the result live (sanitized) with undo.
• design tokens save/show persist a page's extracted palette / type scale / spacing as tokens.json + tokens.css under ~/.navig/data/design (global), or into a space's .navig/design with --space <name> — one design system per project.

How it fits

• No external deps. Generation runs through core's AI client (navig.agent.ai_client) — the architectural law that all inference lives in navig/agent/. Whatever provider you've connected (navig connect) powers it.
• Registers a facet. At boot it plugs a TEXT backend into the core generation registry (navig.media.types.register_generator), so navig generate gen --modality text and the deck media route dispatch through it.
• Refs-library native. Generated Markdown lands as MediaModality.TEXT rows in the same versioned refs library as images / video / audio — so a drafted caption or brief flows straight into navig social fan-out and the content assembly line.

Install

pip install -e plugins/navig-text     # dev (editable)
# or, for the user's real CLI:
navig store install pip:navig-text

Part of the NAVIG media plugin family: navig-image · navig-video · navig-audio · navig-text — each a thin facet over one shared engine.