rapt0r-cli 1.0.0__tar.gz

rapt0r_cli-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 i73
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

rapt0r_cli-1.0.0/PKG-INFO

@@ -0,0 +1,172 @@
+Metadata-Version: 2.4
+Name: rapt0r-cli
+Version: 1.0.0
+Summary: Offline terminal prompt builder — answer a few questions, get a perfect AI prompt in your clipboard. Zero tokens spent on explanations.
+Author: i73
+License: MIT
+Project-URL: Homepage, https://github.com/i73i73i73i73/RAPT0R
+Project-URL: Repository, https://github.com/i73i73i73i73/RAPT0R
+Project-URL: Issues, https://github.com/i73i73i73i73/RAPT0R/issues
+Project-URL: Changelog, https://github.com/i73i73i73i73/RAPT0R/blob/main/CHANGELOG.md
+Keywords: prompt,ai,cli,terminal,tui,prompt-engineering,llm,claude,openai,developer-tools
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: Terminals
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: InquirerPy<0.4,>=0.3.4
+Requires-Dist: rich
+Requires-Dist: pyperclip
+Requires-Dist: PyYAML
+Requires-Dist: Jinja2>=3.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+<img src="docs/rapt0r.png" alt="RAPT0R" width="100%"/>
+
+<br>
+
+**build fast. ship faster.**<br>
+*prompt builder by i73*
+
+[![Python](https://img.shields.io/badge/Python-3.9%2B-blueviolet?style=for-the-badge&logo=python)](https://python.org)
+[![Terminal](https://img.shields.io/badge/CLI-Terminal-darkviolet?style=for-the-badge&logo=gnome-terminal)](https://github.com/i73i73i73i73/RAPT0R)
+[![License](https://img.shields.io/badge/License-MIT-success?style=for-the-badge)](LICENSE)
+
+![demo](docs/demo.gif)
+
+</div>
+
+---
+
+> **Don't spend tokens explaining yourself — spend them on results.**
+
+**RAPT0R** is a terminal prompt builder. Answer a few questions, get a battle-tested AI prompt in your clipboard, or execute it directly against an LLM. Offline by design — your context window goes entirely to the actual work.
+
+## ✨ Features
+
+- 🔌 **Offline by default** — build complex prompts with zero API calls, or optionally stream execution directly to OpenAI/Anthropic.
+- ⚡️ **Fast** — answer 3-5 questions, the finished prompt is already in your clipboard.
+- 📁 **Project context** — drop a `.rapt0r` file in your repo and your stack/rules/architecture get injected into every prompt automatically.
+- 🔎 **Instant search** — press `f` anywhere to fuzzy-search templates across all categories.
+- 🌳 **Branching** — smart templates ask follow-up questions based on your answers.
+- 🛠 **Built-in manager** — create, edit, and delete templates right from the menu.
+- 🎨 **Polished TUI** — custom colors, number hotkeys, icons, built on `InquirerPy` and `rich`.
+
+---
+
+## 🚀 Install
+
+```bash
+pip install rapt0r-cli
+```
+
+Run it:
+
+```bash
+rapt0r
+```
+
+<details>
+<summary>Or run from source</summary>
+
+```bash
+git clone https://github.com/i73i73i73i73/RAPT0R.git
+cd RAPT0R
+pip3 install -e .
+rapt0r          # or: python3 main.py
+```
+</details>
+
+---
+
+## 📁 Project context (`.rapt0r`)
+
+Stop re-explaining your project to the AI in every prompt. Describe it once — RAPT0R appends it to every prompt it builds.
+
+Create a `.rapt0r` file in your project root (any plain text or markdown):
+
+```markdown
+Stack: FastAPI + React + PostgreSQL
+Style: type hints everywhere, no classes where functions do
+Architecture: monorepo, backend in /api, frontend in /web
+Rules: never touch migrations by hand, tests are pytest
+```
+
+Run `rapt0r` from anywhere inside the project — it finds the file by walking up the directory tree and adds a `## Project context` section to the generated prompt.
+
+---
+
+## ⌨️ Hotkeys
+
+| Key | Action |
+|-----|--------|
+| `1-9` | Jump to item |
+| `f` | Fuzzy search across all templates |
+| `0` | Exit / back |
+| `Ctrl+C` | Cancel current flow |
+
+---
+
+## 📝 Writing your own templates
+
+Templates are plain Markdown with **YAML frontmatter**. Press `Create template` in the menu, or drop a `.md` file into a category folder:
+
+```markdown
+---
+name: "✨ My awesome prompt"
+questions:
+  role: "What role should the AI play?"
+  task: "Describe the task in one sentence:"
+branch:
+  question: "Add a constraints section?"
+  y:
+    questions:
+      limits: "List the constraints, comma-separated:"
+    body: "constraints_body"
+---
+
+You act as: {{role}}.
+Your task: {{task}}.
+
+{{constraints_body}}
+```
+
+### Syntax
+
+- `name` — display name in the menu.
+- `questions` — `key: "Question?"` pairs; keys become `{{variables}}` in the body. Add `choices:` for a pick-list.
+- `branch` *(optional)* — yes/no fork that asks extra questions and switches the body.
+- `{{variable}}` — replaced with your answers.
+
+Where templates live: the repo's `rapt0r/templates/` when running from source, `~/.rapt0r/templates/` when installed via pip (seeded automatically on first run). Generated prompts are saved to `~/.rapt0r/prompts/` (or `prompts/temp/` in a source checkout).
+
+---
+
+## 🧠 Philosophy
+
+> **Precise context = fewer tokens = better results.**
+
+Every API call where you explain your project from scratch costs money and context window. RAPT0R forces the discipline of giving the AI exactly the inputs it needs — offline, for free, in seconds.
+
+<div align="center">
+  <sub>built with ❤️ for AI engineering</sub>
+</div>

rapt0r_cli-1.0.0/README.md

@@ -0,0 +1,132 @@
+<div align="center">
+
+<img src="docs/rapt0r.png" alt="RAPT0R" width="100%"/>
+
+<br>
+
+**build fast. ship faster.**<br>
+*prompt builder by i73*
+
+[![Python](https://img.shields.io/badge/Python-3.9%2B-blueviolet?style=for-the-badge&logo=python)](https://python.org)
+[![Terminal](https://img.shields.io/badge/CLI-Terminal-darkviolet?style=for-the-badge&logo=gnome-terminal)](https://github.com/i73i73i73i73/RAPT0R)
+[![License](https://img.shields.io/badge/License-MIT-success?style=for-the-badge)](LICENSE)
+
+![demo](docs/demo.gif)
+
+</div>
+
+---
+
+> **Don't spend tokens explaining yourself — spend them on results.**
+
+**RAPT0R** is a terminal prompt builder. Answer a few questions, get a battle-tested AI prompt in your clipboard, or execute it directly against an LLM. Offline by design — your context window goes entirely to the actual work.
+
+## ✨ Features
+
+- 🔌 **Offline by default** — build complex prompts with zero API calls, or optionally stream execution directly to OpenAI/Anthropic.
+- ⚡️ **Fast** — answer 3-5 questions, the finished prompt is already in your clipboard.
+- 📁 **Project context** — drop a `.rapt0r` file in your repo and your stack/rules/architecture get injected into every prompt automatically.
+- 🔎 **Instant search** — press `f` anywhere to fuzzy-search templates across all categories.
+- 🌳 **Branching** — smart templates ask follow-up questions based on your answers.
+- 🛠 **Built-in manager** — create, edit, and delete templates right from the menu.
+- 🎨 **Polished TUI** — custom colors, number hotkeys, icons, built on `InquirerPy` and `rich`.
+
+---
+
+## 🚀 Install
+
+```bash
+pip install rapt0r-cli
+```
+
+Run it:
+
+```bash
+rapt0r
+```
+
+<details>
+<summary>Or run from source</summary>
+
+```bash
+git clone https://github.com/i73i73i73i73/RAPT0R.git
+cd RAPT0R
+pip3 install -e .
+rapt0r          # or: python3 main.py
+```
+</details>
+
+---
+
+## 📁 Project context (`.rapt0r`)
+
+Stop re-explaining your project to the AI in every prompt. Describe it once — RAPT0R appends it to every prompt it builds.
+
+Create a `.rapt0r` file in your project root (any plain text or markdown):
+
+```markdown
+Stack: FastAPI + React + PostgreSQL
+Style: type hints everywhere, no classes where functions do
+Architecture: monorepo, backend in /api, frontend in /web
+Rules: never touch migrations by hand, tests are pytest
+```
+
+Run `rapt0r` from anywhere inside the project — it finds the file by walking up the directory tree and adds a `## Project context` section to the generated prompt.
+
+---
+
+## ⌨️ Hotkeys
+
+| Key | Action |
+|-----|--------|
+| `1-9` | Jump to item |
+| `f` | Fuzzy search across all templates |
+| `0` | Exit / back |
+| `Ctrl+C` | Cancel current flow |
+
+---
+
+## 📝 Writing your own templates
+
+Templates are plain Markdown with **YAML frontmatter**. Press `Create template` in the menu, or drop a `.md` file into a category folder:
+
+```markdown
+---
+name: "✨ My awesome prompt"
+questions:
+  role: "What role should the AI play?"
+  task: "Describe the task in one sentence:"
+branch:
+  question: "Add a constraints section?"
+  y:
+    questions:
+      limits: "List the constraints, comma-separated:"
+    body: "constraints_body"
+---
+
+You act as: {{role}}.
+Your task: {{task}}.
+
+{{constraints_body}}
+```
+
+### Syntax
+
+- `name` — display name in the menu.
+- `questions` — `key: "Question?"` pairs; keys become `{{variables}}` in the body. Add `choices:` for a pick-list.
+- `branch` *(optional)* — yes/no fork that asks extra questions and switches the body.
+- `{{variable}}` — replaced with your answers.
+
+Where templates live: the repo's `rapt0r/templates/` when running from source, `~/.rapt0r/templates/` when installed via pip (seeded automatically on first run). Generated prompts are saved to `~/.rapt0r/prompts/` (or `prompts/temp/` in a source checkout).
+
+---
+
+## 🧠 Philosophy
+
+> **Precise context = fewer tokens = better results.**
+
+Every API call where you explain your project from scratch costs money and context window. RAPT0R forces the discipline of giving the AI exactly the inputs it needs — offline, for free, in seconds.
+
+<div align="center">
+  <sub>built with ❤️ for AI engineering</sub>
+</div>

rapt0r_cli-1.0.0/pyproject.toml

@@ -0,0 +1,77 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "rapt0r-cli"
+version = "1.0.0"
+description = "Offline terminal prompt builder — answer a few questions, get a perfect AI prompt in your clipboard. Zero tokens spent on explanations."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "i73" }]
+keywords = [
+    "prompt",
+    "ai",
+    "cli",
+    "terminal",
+    "tui",
+    "prompt-engineering",
+    "llm",
+    "claude",
+    "openai",
+    "developer-tools",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development",
+    "Topic :: Terminals",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "InquirerPy>=0.3.4,<0.4",
+    "rich",
+    "pyperclip",
+    "PyYAML",
+    "Jinja2>=3.0",
+]
+
+[project.optional-dependencies]
+dev = ["pytest", "ruff", "build"]
+
+[project.urls]
+Homepage = "https://github.com/i73i73i73i73/RAPT0R"
+Repository = "https://github.com/i73i73i73i73/RAPT0R"
+Issues = "https://github.com/i73i73i73i73/RAPT0R/issues"
+Changelog = "https://github.com/i73i73i73i73/RAPT0R/blob/main/CHANGELOG.md"
+
+[project.scripts]
+rapt0r = "rapt0r.main:main"
+
+[tool.setuptools.packages.find]
+include = ["rapt0r*"]
+
+[tool.setuptools.package-data]
+rapt0r = ["templates/*.md", "templates/**/*.md"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+target-version = "py39"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "W"]
+ignore = ["E501"]

rapt0r_cli-1.0.0/rapt0r/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"

rapt0r_cli-1.0.0/rapt0r/__main__.py

@@ -0,0 +1,4 @@
+from rapt0r.main import main
+
+if __name__ == "__main__":
+    main()

rapt0r_cli-1.0.0/rapt0r/core/builder.py

@@ -0,0 +1,20 @@
+import logging
+from jinja2 import Environment, BaseLoader, DebugUndefined
+
+from rapt0r.core.utils import DEFAULT_BODY
+from rapt0r.core.context_vars import extract_context_vars, resolve_context_vars
+
+logger = logging.getLogger(__name__)
+
+_env = Environment(loader=BaseLoader(), undefined=DebugUndefined, keep_trailing_newline=True)
+
+
+def build_prompt(bodies, answers, body_key=None):
+    key = body_key if body_key and body_key in bodies else DEFAULT_BODY
+    if key not in bodies:
+        logger.warning(f"Body section {key!r} not found, using first available")
+        key = next(iter(bodies))
+    vars_ = {k: v for k, v in answers.items() if not k.startswith("__")}
+    body, pending = extract_context_vars(bodies[key])
+    result = _env.from_string(body).render(**vars_)
+    return resolve_context_vars(result, pending)

rapt0r_cli-1.0.0/rapt0r/core/context_vars.py

@@ -0,0 +1,97 @@
+"""Dynamic context variables: {{git_diff}}, {{tree}}, {{tree:path}}, {{file:path}}.
+
+The colon forms are not valid Jinja2 syntax, and injected content may itself
+contain ``{{``, so these tokens are swapped for opaque sentinels before the
+Jinja2 render and resolved afterwards (see builder.build_prompt).
+"""
+
+import os
+import re
+import subprocess
+
+MAX_BYTES = 30000
+MAX_TREE_ENTRIES = 500
+SKIP_DIRS = {"__pycache__", "node_modules", "venv", ".venv"}
+
+CONTEXT_VAR_NAMES = {"git_diff", "tree", "file"}
+
+_PATTERN = re.compile(r"\{\{\s*(git_diff|tree|file)(?::([^}]+))?\s*\}\}")
+
+
+def _truncate(text):
+    if len(text) > MAX_BYTES:
+        return text[:MAX_BYTES] + "\n... [truncated]"
+    return text
+
+
+def _git_diff():
+    try:
+        out = subprocess.run(
+            ["git", "diff", "HEAD"], capture_output=True, text=True, timeout=10
+        )
+    except (OSError, subprocess.TimeoutExpired):
+        return "[git diff unavailable]"
+    if out.returncode != 0:
+        return "[git diff unavailable: not a git repository?]"
+    return _truncate(out.stdout.strip()) or "[no uncommitted changes]"
+
+
+def _tree(root):
+    root = (root or ".").strip() or "."
+    if not os.path.isdir(root):
+        return f"[directory not found: {root}]"
+    lines = []
+    for dirpath, dirnames, filenames in os.walk(root):
+        dirnames[:] = sorted(
+            d for d in dirnames if not d.startswith(".") and d not in SKIP_DIRS
+        )
+        for f in sorted(filenames):
+            lines.append(os.path.relpath(os.path.join(dirpath, f), root))
+            if len(lines) >= MAX_TREE_ENTRIES:
+                lines.append("... [truncated]")
+                return "\n".join(lines)
+    return "\n".join(lines) or "[empty directory]"
+
+
+def _file(path):
+    path = (path or "").strip()
+    try:
+        with open(path, "r", encoding="utf-8", errors="replace") as f:
+            return _truncate(f.read())
+    except OSError as e:
+        return f"[could not read {path}: {e}]"
+
+
+def _resolve(kind, arg):
+    if kind == "git_diff":
+        return _git_diff()
+    if kind == "tree":
+        return _tree(arg)
+    if kind == "file":
+        return _file(arg)
+    return ""
+
+
+def extract_context_vars(text):
+    """Replace context tokens with sentinels safe to pass through Jinja2."""
+    pending = {}
+
+    def repl(m):
+        token = f"\x00CTX{len(pending)}\x00"
+        pending[token] = (m.group(1), m.group(2))
+        return token
+
+    return _PATTERN.sub(repl, text), pending
+
+
+def resolve_context_vars(text, pending):
+    """Substitute sentinels with their resolved content after the render."""
+    for token, (kind, arg) in pending.items():
+        text = text.replace(token, _resolve(kind, arg))
+    return text
+
+
+def expand_context_vars(text):
+    """One-shot expansion (extract + resolve), used directly in tests."""
+    extracted, pending = extract_context_vars(text)
+    return resolve_context_vars(extracted, pending)

rapt0r_cli-1.0.0/rapt0r/core/llm.py

@@ -0,0 +1,123 @@
+"""Stream a built prompt to an LLM over raw HTTP (no SDK dependencies).
+
+Providers are detected from environment variables:
+  ANTHROPIC_API_KEY -> Anthropic Messages API
+  OPENAI_API_KEY    -> OpenAI Chat Completions API
+
+Model overrides: RAPT0R_ANTHROPIC_MODEL, RAPT0R_OPENAI_MODEL.
+"""
+
+import json
+import os
+import urllib.error
+import urllib.request
+
+ANTHROPIC_URL = "https://api.anthropic.com/v1/messages"
+OPENAI_URL = "https://api.openai.com/v1/chat/completions"
+
+DEFAULT_ANTHROPIC_MODEL = "claude-opus-4-8"
+DEFAULT_OPENAI_MODEL = "gpt-5-codex"
+
+TIMEOUT = 600
+
+
+class LLMError(Exception):
+    pass
+
+
+def available_providers():
+    providers = []
+    if os.environ.get("ANTHROPIC_API_KEY"):
+        providers.append("anthropic")
+    if os.environ.get("OPENAI_API_KEY"):
+        providers.append("openai")
+    return providers
+
+
+def iter_sse_data(lines):
+    """Yield parsed JSON payloads from an iterable of raw SSE byte lines."""
+    for raw in lines:
+        line = raw.decode("utf-8", errors="replace").strip()
+        if not line.startswith("data:"):
+            continue
+        data = line[len("data:"):].strip()
+        if data == "[DONE]":
+            return
+        try:
+            yield json.loads(data)
+        except json.JSONDecodeError:
+            continue
+
+
+def _post_stream(url, headers, body):
+    req = urllib.request.Request(
+        url, data=json.dumps(body).encode("utf-8"), headers=headers, method="POST"
+    )
+    try:
+        return urllib.request.urlopen(req, timeout=TIMEOUT)
+    except urllib.error.HTTPError as e:
+        detail = e.read().decode("utf-8", errors="replace")[:500]
+        raise LLMError(f"HTTP {e.code}: {detail}") from e
+    except urllib.error.URLError as e:
+        raise LLMError(f"Network error: {e.reason}") from e
+
+
+def _stream_anthropic(prompt):
+    model = os.environ.get("RAPT0R_ANTHROPIC_MODEL", DEFAULT_ANTHROPIC_MODEL)
+    resp = _post_stream(
+        ANTHROPIC_URL,
+        {
+            "x-api-key": os.environ["ANTHROPIC_API_KEY"],
+            "anthropic-version": "2023-06-01",
+            "content-type": "application/json",
+        },
+        {
+            "model": model,
+            "max_tokens": 64000,
+            "stream": True,
+            "thinking": {"type": "adaptive"},
+            "messages": [{"role": "user", "content": prompt}],
+        },
+    )
+    with resp:
+        for event in iter_sse_data(resp):
+            etype = event.get("type")
+            if etype == "content_block_delta":
+                delta = event.get("delta", {})
+                if delta.get("type") == "text_delta":
+                    yield delta.get("text", "")
+            elif etype == "error":
+                raise LLMError(event.get("error", {}).get("message", "stream error"))
+
+
+def _stream_openai(prompt):
+    model = os.environ.get("RAPT0R_OPENAI_MODEL", DEFAULT_OPENAI_MODEL)
+    resp = _post_stream(
+        OPENAI_URL,
+        {
+            "Authorization": f"Bearer {os.environ['OPENAI_API_KEY']}",
+            "content-type": "application/json",
+        },
+        {
+            "model": model,
+            "stream": True,
+            "messages": [{"role": "user", "content": prompt}],
+        },
+    )
+    with resp:
+        for event in iter_sse_data(resp):
+            choices = event.get("choices") or []
+            if choices:
+                text = choices[0].get("delta", {}).get("content")
+                if text:
+                    yield text
+
+
+def stream_completion(prompt, provider):
+    """Yield response text chunks from the given provider."""
+    if provider == "anthropic":
+        yield from _stream_anthropic(prompt)
+    elif provider == "openai":
+        yield from _stream_openai(prompt)
+    else:
+        raise LLMError(f"Unknown provider: {provider}")