NLP2CMD
AI Cost Tracking
- 🤖 LLM usage: $37.4979 (300 commits)
- 👤 Human dev: ~$11023 (110.2h @ $100/h, 30min dedup)
Generated on 2026-07-06 using openrouter/deep/deep-v4-pro
---
Natural Language → Domain-Specific Commands — production-ready framework for transforming natural language (Polish + English) into shell, SQL, Docker, Kubernetes, browser automation, and desktop GUI commands.
Quick Start
pip install nlp2cmd[all]
nlp2cmd cache auto-setup # Setup Playwright browsers
# Single commands
nlp2cmd "uruchom usługę nginx" # → systemctl start nginx
nlp2cmd "znajdź pliki większe niż 100MB" # → find . -type f -size +100MB
# Multi-step browser automation
nlp2cmd -r "otwórz openrouter.ai, wyciągnij klucz API i zapisz do .env"
# Canvas drawing with video recording
nlp2cmd -r "wejdź na jspaint.app i narysuj biedronkę" --video webmnlp2cmd -r "wejdź na jspaint.app i narysuj psa" --video webm nlp2cmd -r "wejdź na jspaint.app i narysuj kota" --video webm nlp2cmd -r "wejdź na jspaint.app i narysuj dziecko" --video webm
Web form filling
nlp2cmd -r "otwórz https://example.com/kontakt i wypełnij formularz i wyślij"
## Integracja z nlp2dsl / Propact
nlp2cmd to **runner** — planowanie i wykonanie. **Struktura zapytania** (IntentIR) pochodzi z pakietów nlp2dsl; na wejściu każdego zapytania uruchamiana jest analiza nlp2dsl.
| Narzędzie | Rola |
|-----------|------|
| `nlp2dsl show` | Tylko struktura (IntentIR) — bez wykonania |
| `nlp2cmd plan` | Plan → Propact markdown; `--execute` → hybrid executor |
| `nlp2cmd -q … -r` | Legacy runtime (shell / browser / canvas) |
### Routing wykonania (`--execute`)| targetkind | Executor | |---------------|----------| | shell, rest, mcp, ws | Propact (shell: fallback subprocess gdy brak CLI) | | browser, sql, desktop | nlp2cmd PipelineRunner |
--explain / --json pokazują executionroutes per krok.
Instalacja (dev, monorepo)
# Zalecane — jedna komenda (nlp2dsl packages + nlp2cmd[integration])
cd nlp2cmd && make update
# lub ręcznie:
cd ../nlp2dsl && ./scripts/setup-dev.sh
export NLP2CMD_INTEGRATION=1
export LANG=C.UTF-8Uwaga: nlp2cmd wymaga pakietów z nlp2dsl/packages/ (editable). Uruchamiaj CLI z tego samego venv co make update (which nlp2cmd → .venv/bin/nlp2cmd). Stary ~/.local/bin/nlp2cmd nie widzi integracji.
make update # przeinstaluj zależności integracji (--upgrade)
make publish # update + bump patch + PyPI (nie uruchamiaj bez potrzeby)