necvk

Convert any URL to clean markdown or forge agent-ready skill.md files from your terminal.

npx @divikk/necvk init
npx @divikk/necvk f https://docs.bags.fm/llms.txt
npx @divikk/necvk c https://google.com

Natively built for crypto protocols (like the Bags API) and Google Workspace CLI extraction. Instantly ingest entire llms.txt indexes and translate them into autonomous trading/coding skills for Claude, Cursor, and Cline.

Setup (The Wizard)

Get started instantly with the interactive wizard:

npx @divikk/necvk init

Select your LLM provider (OpenAI, MiniMax, Groq, local Ollama) and securely store your API key without complex flags.

Commands

forge (shortcut: f) — AI-powered skill generation

Turn complex documentation indexes into autonomous agent skills. Directly drop in an llms.txt index file, and Nectar will recursively parse the child documentation natively.

necvk f <url|file>

# Examples
necvk f https://docs.bags.fm/llms.txt --mode recipe
necvk f https://react.dev/learn/hooks
necvk f ./api-docs.md --mode api --stdout
necvk f <url> --provider ollama --mode recipe   # local Ollama, no key needed

Providers: openai | openrouter | groq | minimax | ollama

Modes: howto (default) | debug | api | recipe | architecture

After forging, Nectar provides ready-to-paste install commands for Claude Code, Cursor, and Cline.

convert (shortcut: c) — Unlimited markdown extraction

Drop Google Workspace CLI outputs, YouTube links, PDFs, or standard URLs and get perfect markdown back—no LLM overhead, completely free.

necvk c <url|file|text>

# Examples
necvk c https://docs.bags.fm/principles/token-launch-workflow
necvk c https://youtu.be/dQw4w9WgXcQ 
necvk c ./docs.md                      
necvk c <url> -o output.md             

3-tier extraction:

1. Native protocol matching (llms.txt, text/markdown, YouTube Transcripts)
2. Jina Reader API for SPAs / JS-heavy pages
3. HTML fetch + advanced markdown conversion

config (shortcut: cfg)

Manually update your API key or provider at any time:

necvk cfg --key sk-xxx --provider openai
necvk cfg --show

providers / modes

necvk providers    # list all supported LLM providers
necvk modes        # list skill generation modes

Key Priority

1. --key <key> flag
2. Environment variable (OPENAI_API_KEY, GROQ_API_KEY, etc.)
3. ~/.nectarrc config file

License

MIT