rtdm 0.2.0__tar.gz

rtdm-0.2.0/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "WebFetch(domain:github.com)",
+      "Bash(git add:*)"
+    ]
+  }
+}

rtdm-0.2.0/.gitignore

@@ -0,0 +1,30 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+build/
+dist/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Test / type-check caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# Editor / OS
+.vscode/
+.idea/
+.DS_Store
+*.swp
+
+# Local config (user-specific; never committed)
+config.toml

rtdm-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 t3t5u0403
+
+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.

rtdm-0.2.0/LOCAL.md

@@ -0,0 +1,89 @@
+# Local mode setup
+
+Local mode runs entirely on your machine. No API key, no network call
+to anything but your own Ollama daemon. Privacy is whatever your
+laptop's privacy is.
+
+## Steps
+
+1. **Install Ollama:**
+
+   ```
+   curl -fsSL https://ollama.com/install.sh | sh
+   ```
+
+   Or grab a binary from <https://ollama.com/download>.
+
+2. **Pull a model:**
+
+   ```
+   ollama pull qwen2.5-coder:7b-instruct-q4_K_M
+   ```
+
+   This is the default rtdm uses. If you want a different model, pull
+   it and set `model` in `~/.config/rtdm/config.toml`.
+
+3. **Configure rtdm:**
+
+   ```
+   rtdm config init
+   ```
+
+   Pick `local` when prompted. The defaults (Ollama on localhost:11434,
+   the model above) are usually correct.
+
+4. **Try it:**
+
+   ```
+   rtdm find files over 100mb
+   ```
+
+   The first run is slow because Ollama loads the model into memory.
+   Subsequent calls are quick.
+
+## Hardware requirements
+
+The 7b-quant model (≈4.5 GB on disk) needs ~8 GB RAM to load. A
+discrete GPU with 6+ GB VRAM gets you sub-second responses; an RTX
+3060 or M2-class Apple Silicon is a comfortable floor.
+
+CPU-only works but expect 10+ second waits. If that's painful, the
+hosted service at rtdm.sh exists.
+
+## Pointing rtdm at a remote Ollama
+
+Useful for "Ollama on my desktop, rtdm on my laptop" setups (e.g.
+over Tailscale or a LAN). Edit the config:
+
+```toml
+mode = "local"
+
+[local]
+ollama_url = "http://desktop.tailnet:11434"
+model = "qwen2.5-coder:7b-instruct-q4_K_M"
+```
+
+The local backend will speak HTTP/HTTPS to whatever URL you give it —
+the name "local" refers to *no third-party API*, not the network
+location.
+
+## Choosing a different model
+
+Anything Ollama can serve will work; rtdm just sends the prompt and
+streams the reply. Smaller models (e.g. `qwen2.5-coder:1.5b`) are
+faster but worse at obscure commands; larger models (e.g.
+`qwen2.5-coder:32b`) are slower but more reliable.
+
+If a model produces output with markdown fences or commentary despite
+the system prompt, switch to one trained more on instruction-following.
+
+## Account subcommands in local mode
+
+The `rtdm portal`, `rtdm rotate`, and `rtdm usage` subcommands are
+hosted-mode features (they all hit `rtdm.sh`). In local mode they
+print a one-line "remote mode only" message and exit 1 — there's no
+subscription to manage, no key to rotate, and no quota to count
+against.
+
+`rtdm whoami` works fine in local mode and shows your Ollama URL and
+model instead of a remote endpoint.

rtdm-0.2.0/PKG-INFO

@@ -0,0 +1,185 @@
+Metadata-Version: 2.4
+Name: rtdm
+Version: 0.2.0
+Summary: An AI shell helper that gives you the command without the commentary.
+Project-URL: Homepage, https://rtdm.sh
+Project-URL: Repository, https://github.com/t3t5u0403/rtdm-cli
+Project-URL: Issues, https://github.com/t3t5u0403/rtdm-cli/issues
+Author: rtdm contributors
+License: MIT
+License-File: LICENSE
+Keywords: ai,cli,ollama,shell,terminal
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# rtdm
+
+read the damn manual.
+
+An AI shell helper that gives you the command without the commentary.
+
+```
+$ rtdm find files over 100mb
+find . -size +100M
+```
+
+## Install
+
+```
+pipx install rtdm
+rtdm config init
+```
+
+`rtdm config init` walks you through a one-time setup. Pick `local`
+for free, self-hosted use, or `remote` if you have an API key from
+[rtdm.sh](https://rtdm.sh).
+
+## Usage
+
+### Three modes
+
+```
+rtdm <query>           # get a shell command
+rtdm -q <question>     # ask a general terminal question
+rtdm -e <command>      # explain a command
+```
+
+Multi-word queries don't need quotes — words after the flags are
+joined with spaces:
+
+```
+rtdm find files over 100mb     # works
+rtdm "find files over 100mb"   # also works
+```
+
+The exception is when your input contains characters the shell would
+interpret — globs (`*`, `?`, `[]`), control operators (`;`, `|`, `&`,
+`<`, `>`), or arguments that look like flags (e.g. `--recursive`).
+Quote those:
+
+```
+rtdm -e "find . -mtime -7 -exec rm {} \;"
+```
+
+Plain dashes are fine; `rtdm find files -size 100mb` works without
+quoting.
+
+### Flags
+
+| Flag | Effect                                                         |
+|------|----------------------------------------------------------------|
+| `-c` | Copy the output to the clipboard                               |
+| `-x` | Execute the returned command (cmd mode only, with confirmation)|
+
+### Subcommands
+
+Account self-service for hosted-mode users. All require remote mode
+(except `whoami`, which works in either mode).
+
+| Subcommand     | Effect                                                          |
+|----------------|-----------------------------------------------------------------|
+| `rtdm portal`  | Open the Stripe billing portal (manage subscription, invoices)  |
+| `rtdm rotate`  | Issue a new API key, revoke the old one, update local config    |
+| `rtdm usage`   | Show this month's usage and remaining quota                     |
+| `rtdm whoami`  | Show which key/host this CLI is configured against (no network) |
+
+### Examples
+
+```
+$ rtdm extract a tar.gz file
+tar -xzf archive.tar.gz
+
+$ rtdm -q what does grep -E do
+grep -E enables extended regular expressions, allowing operators like
++, ?, |, (), and {} without backslash escaping.
+
+$ rtdm -e "find . -mtime -7 -exec rm {} \;"
+This finds every file under the current directory modified in the last
+7 days and deletes each one. -mtime -7 selects "less than 7 days ago";
+-exec rm {} \; runs rm on each match.
+
+$ rtdm -c list all my docker containers
+docker ps -a
+(copied to clipboard)
+```
+
+## Local mode (free, self-hosted)
+
+Run your own [Ollama](https://ollama.com), point rtdm at it. No API
+key needed, no network call to anything but your own machine. Free
+forever.
+
+See [LOCAL.md](LOCAL.md) for setup.
+
+## Hosted mode ($3/month)
+
+We run rtdm at [rtdm.sh](https://rtdm.sh) on dedicated GPU hardware.
+No setup, no Ollama install, no model downloads — just one HTTP call
+per query. 500 queries per month, cancel anytime.
+
+Sign up at [rtdm.sh](https://rtdm.sh).
+
+## Privacy
+
+We don't log your queries on our servers. We don't train models on
+them. We don't sell anything to anyone.
+
+We do use Cloudflare in front for DDoS protection, which means
+Cloudflare technically sees TLS-decrypted requests as they pass
+through. Most modern services work this way and we think the
+protection is worth it, but we know some of you will disagree. See
+[rtdm.sh](https://rtdm.sh) for the full note.
+
+If you want zero third parties in the path, use local mode.
+
+## Configuration
+
+The config file lives at `~/.config/rtdm/config.toml` (or
+`$XDG_CONFIG_HOME/rtdm/config.toml`):
+
+```toml
+mode = "remote"  # or "local"
+
+[remote]
+api_key = "rtdm_live_..."
+endpoint = "https://rtdm.sh"
+
+[local]
+ollama_url = "http://localhost:11434"
+model = "qwen2.5-coder:7b-instruct-q4_K_M"
+```
+
+Useful subcommands:
+
+```
+rtdm config init     # interactive setup
+rtdm config show     # print effective configuration
+rtdm config path     # print the config file location
+```
+
+## Development
+
+```
+git clone https://github.com/t3t5u0403/rtdm-cli
+cd rtdm-cli
+uv sync --extra dev
+uv run pytest
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE).

rtdm-0.2.0/README.md

@@ -0,0 +1,157 @@
+# rtdm
+
+read the damn manual.
+
+An AI shell helper that gives you the command without the commentary.
+
+```
+$ rtdm find files over 100mb
+find . -size +100M
+```
+
+## Install
+
+```
+pipx install rtdm
+rtdm config init
+```
+
+`rtdm config init` walks you through a one-time setup. Pick `local`
+for free, self-hosted use, or `remote` if you have an API key from
+[rtdm.sh](https://rtdm.sh).
+
+## Usage
+
+### Three modes
+
+```
+rtdm <query>           # get a shell command
+rtdm -q <question>     # ask a general terminal question
+rtdm -e <command>      # explain a command
+```
+
+Multi-word queries don't need quotes — words after the flags are
+joined with spaces:
+
+```
+rtdm find files over 100mb     # works
+rtdm "find files over 100mb"   # also works
+```
+
+The exception is when your input contains characters the shell would
+interpret — globs (`*`, `?`, `[]`), control operators (`;`, `|`, `&`,
+`<`, `>`), or arguments that look like flags (e.g. `--recursive`).
+Quote those:
+
+```
+rtdm -e "find . -mtime -7 -exec rm {} \;"
+```
+
+Plain dashes are fine; `rtdm find files -size 100mb` works without
+quoting.
+
+### Flags
+
+| Flag | Effect                                                         |
+|------|----------------------------------------------------------------|
+| `-c` | Copy the output to the clipboard                               |
+| `-x` | Execute the returned command (cmd mode only, with confirmation)|
+
+### Subcommands
+
+Account self-service for hosted-mode users. All require remote mode
+(except `whoami`, which works in either mode).
+
+| Subcommand     | Effect                                                          |
+|----------------|-----------------------------------------------------------------|
+| `rtdm portal`  | Open the Stripe billing portal (manage subscription, invoices)  |
+| `rtdm rotate`  | Issue a new API key, revoke the old one, update local config    |
+| `rtdm usage`   | Show this month's usage and remaining quota                     |
+| `rtdm whoami`  | Show which key/host this CLI is configured against (no network) |
+
+### Examples
+
+```
+$ rtdm extract a tar.gz file
+tar -xzf archive.tar.gz
+
+$ rtdm -q what does grep -E do
+grep -E enables extended regular expressions, allowing operators like
++, ?, |, (), and {} without backslash escaping.
+
+$ rtdm -e "find . -mtime -7 -exec rm {} \;"
+This finds every file under the current directory modified in the last
+7 days and deletes each one. -mtime -7 selects "less than 7 days ago";
+-exec rm {} \; runs rm on each match.
+
+$ rtdm -c list all my docker containers
+docker ps -a
+(copied to clipboard)
+```
+
+## Local mode (free, self-hosted)
+
+Run your own [Ollama](https://ollama.com), point rtdm at it. No API
+key needed, no network call to anything but your own machine. Free
+forever.
+
+See [LOCAL.md](LOCAL.md) for setup.
+
+## Hosted mode ($3/month)
+
+We run rtdm at [rtdm.sh](https://rtdm.sh) on dedicated GPU hardware.
+No setup, no Ollama install, no model downloads — just one HTTP call
+per query. 500 queries per month, cancel anytime.
+
+Sign up at [rtdm.sh](https://rtdm.sh).
+
+## Privacy
+
+We don't log your queries on our servers. We don't train models on
+them. We don't sell anything to anyone.
+
+We do use Cloudflare in front for DDoS protection, which means
+Cloudflare technically sees TLS-decrypted requests as they pass
+through. Most modern services work this way and we think the
+protection is worth it, but we know some of you will disagree. See
+[rtdm.sh](https://rtdm.sh) for the full note.
+
+If you want zero third parties in the path, use local mode.
+
+## Configuration
+
+The config file lives at `~/.config/rtdm/config.toml` (or
+`$XDG_CONFIG_HOME/rtdm/config.toml`):
+
+```toml
+mode = "remote"  # or "local"
+
+[remote]
+api_key = "rtdm_live_..."
+endpoint = "https://rtdm.sh"
+
+[local]
+ollama_url = "http://localhost:11434"
+model = "qwen2.5-coder:7b-instruct-q4_K_M"
+```
+
+Useful subcommands:
+
+```
+rtdm config init     # interactive setup
+rtdm config show     # print effective configuration
+rtdm config path     # print the config file location
+```
+
+## Development
+
+```
+git clone https://github.com/t3t5u0403/rtdm-cli
+cd rtdm-cli
+uv sync --extra dev
+uv run pytest
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE).

rtdm-0.2.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "rtdm"
+version = "0.2.0"
+description = "An AI shell helper that gives you the command without the commentary."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+keywords = ["cli", "ollama", "shell", "ai", "terminal"]
+authors = [{ name = "rtdm contributors" }]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "httpx>=0.27",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+]
+
+[project.scripts]
+rtdm = "rtdm.main:main"
+
+[project.urls]
+Homepage = "https://rtdm.sh"
+Repository = "https://github.com/t3t5u0403/rtdm-cli"
+Issues = "https://github.com/t3t5u0403/rtdm-cli/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/rtdm"]

rtdm-0.2.0/src/rtdm/__init__.py

@@ -0,0 +1,8 @@
+"""rtdm — read the damn manual.
+
+An AI shell helper that gives you the command without the commentary.
+Runs against either local Ollama (free, self-hosted) or the hosted
+service at rtdm.sh (paid, no setup).
+"""
+
+__version__ = "0.2.0"

rtdm-0.2.0/src/rtdm/backends/__init__.py

@@ -0,0 +1,13 @@
+"""Backend implementations for the rtdm CLI.
+
+Two backends share the same three-function shape so the dispatcher
+in ``rtdm.main`` can swap them transparently:
+
+* :func:`query`  — natural language → single shell command
+* :func:`ask`    — free-form terminal question → plain-English answer
+* :func:`explain`— shell command → plain-English breakdown
+
+The local backend streams tokens from a user-run Ollama instance.  The
+remote backend POSTs to ``rtdm.sh`` and prints the full response on
+completion.  Streaming over HTTPS is intentionally deferred.
+"""