promptqueue 0.1.0__tar.gz

promptqueue-0.1.0/LICENSE

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

promptqueue-0.1.0/PKG-INFO

@@ -0,0 +1,332 @@
+Metadata-Version: 2.4
+Name: promptqueue
+Version: 0.1.0
+Summary: Dependency-free prompt scheduler for AI rate-limit resets.
+Author: Atharva Maik
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/AtharvaMaik/PromptQueue
+Project-URL: Repository, https://github.com/AtharvaMaik/PromptQueue
+Project-URL: Issues, https://github.com/AtharvaMaik/PromptQueue/issues
+Keywords: ai,automation,scheduler,claude,codex,chatgpt,cursor,gemini
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+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 :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# PromptQueue
+
+[![CI](https://github.com/AtharvaMaik/PromptQueue/actions/workflows/ci.yml/badge.svg)](https://github.com/AtharvaMaik/PromptQueue/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
+[![PyPI](https://img.shields.io/pypi/v/promptqueue.svg)](https://pypi.org/project/promptqueue/)
+
+Schedule AI prompts for the moment your limits reset.
+
+PromptQueue is a tiny, dependency-free prompt scheduler for Claude, Codex, ChatGPT, Gemini, Copilot, Cursor, Antigravity, and anything else you can launch from your machine.
+
+When an AI tool says "try again at 7:30 PM", do not keep the tab open, set a reminder, or paste the same prompt later. Queue it now. PromptQueue waits, opens or focuses the target app, pastes the prompt, and submits it when the time arrives.
+
+```powershell
+promptqueue add 19:30 claude finish the migration plan
+promptqueue run
+```
+
+One Python file. Standard library only. No accounts, no server, no private APIs.
+
+![PromptQueue terminal demo](https://raw.githubusercontent.com/AtharvaMaik/PromptQueue/main/docs/demo.svg)
+
+## Why This Exists
+
+AI rate limits waste the worst kind of time: attention.
+
+You already know what you want to ask next. The only problem is the clock. PromptQueue turns "come back later" into a queued job you can trust.
+
+Use it when:
+
+- Claude, Codex, ChatGPT, Gemini, or Copilot tells you to wait for a reset
+- you want a long prompt to run after you sleep
+- you want a coding agent to resume work when capacity returns
+- you want a dead-simple local queue instead of another SaaS dashboard
+
+If this saves you one context switch, it has already done its job.
+
+## 30 Second Demo
+
+Queue a Claude prompt for 11:30 PM:
+
+```powershell
+promptqueue add 23:30 claude write a first draft of the launch email
+promptqueue run
+```
+
+Queue a Codex CLI prompt:
+
+```powershell
+promptqueue add 23:30 codex-exec add tests for the queue runner
+promptqueue run
+```
+
+Queue a multiline prompt safely:
+
+```powershell
+@'
+Review this repo.
+Find the smallest useful next improvement.
+Then implement it.
+'@ | promptqueue add --stdin 23:30 claude
+promptqueue run
+```
+
+View what is waiting:
+
+```powershell
+promptqueue list --full
+promptqueue show JOB_ID
+```
+
+## Supported Targets
+
+```text
+antigravity  Google Antigravity UI
+chatgpt      ChatGPT web UI
+claude       Claude web UI
+claude-code  Claude CLI
+codex        Codex desktop UI
+codex-exec   Codex CLI
+copilot      Copilot web UI
+copy         clipboard only
+cursor       Cursor UI
+gemini       Gemini web UI
+```
+
+Run this to see the built-in aliases on your machine:
+
+```powershell
+promptqueue targets
+```
+
+UI targets open or focus the app, click near the composer, paste, then press Enter by default.
+
+CLI targets run the command directly with the prompt as one argument.
+
+## Agent Ready
+
+This repo includes instruction files for common AI coding tools:
+
+```text
+AGENTS.md                         Codex and general agents
+CLAUDE.md                         Claude Code
+GEMINI.md                         Gemini CLI
+.cursor/rules/promptqueue.mdc     Cursor
+.agents/skills/promptqueue/       Antigravity-style skill
+```
+
+That means you can tell an agent:
+
+```text
+My limits reset at 7:30 pm. Schedule this prompt for Claude:
+"Continue the refactor and run the tests."
+```
+
+The agent should queue it with PromptQueue instead of making you remember.
+
+## Requirements
+
+- Python 3.10+
+- Windows for GUI paste/submit automation
+- macOS/Linux work for queue management, URLs, clipboard fallback, and CLI targets, but GUI paste currently uses Windows APIs
+
+## Install
+
+Install from PyPI:
+
+```powershell
+pip install promptqueue
+promptqueue selftest
+```
+
+Or clone the repo and run the single Python file:
+
+```powershell
+git clone https://github.com/AtharvaMaik/PromptQueue.git
+cd PromptQueue
+python promptqueue.py selftest
+```
+
+After `pip install`, use `promptqueue`. When running from a clone without installing, use `python promptqueue.py`.
+
+PromptQueue stores jobs in:
+
+```text
+%USERPROFILE%\.promptqueue.json
+```
+
+Override the queue path when you want an isolated queue:
+
+```powershell
+$env:PROMPTQUEUE_FILE="C:\path\queue.json"
+```
+
+## How It Works
+
+1. `add` writes a job to the local queue file.
+2. `run` checks for due jobs.
+3. When a job is due, PromptQueue copies the prompt to the clipboard.
+4. For UI targets, it opens or focuses the app, clicks the composer, pastes, and optionally submits.
+5. For CLI targets, it launches the command directly.
+6. Attempts, failures, retries, and history stay visible in the queue file.
+
+If the machine wakes up after the scheduled time, `run` catches overdue jobs.
+
+## Commands
+
+### `add`
+
+Queue a prompt.
+
+```powershell
+promptqueue add [options] WHEN TARGET PROMPT...
+```
+
+`WHEN` can be a local time like `23:30` or an ISO-ish datetime like `2026-06-24 01:15`.
+
+Options:
+
+```text
+--click bottom                 Click near the bottom of the focused window before paste.
+--click x,y                    Click x/y pixels from the target window top-left.
+--command-template TEMPLATE    Run a custom command; use {prompt}.
+--delay SECONDS                Wait before paste/submit. Default: 5.
+--file FILE                    Read prompt text from a UTF-8 file.
+--max-attempts N               Attempts before marking failed. Default: 5.
+--no-submit                    Paste only; do not press Enter.
+--pre-keys KEYS                Windows SendKeys before paste, e.g. "{ESC}".
+--retry-base SECONDS           Initial retry delay. Default: 30.
+--stdin                        Read prompt text from stdin.
+--window TITLE                 Focus a window whose title contains TITLE.
+```
+
+Examples:
+
+```powershell
+promptqueue add 23:30 claude summarize this paper
+promptqueue add --window Codex 23:30 copy this lands in Codex
+promptqueue add --no-submit 23:30 claude paste this but do not send it
+promptqueue add --file prompt.txt 23:30 claude
+"prompt from stdin" | promptqueue add --stdin 23:30 copy
+promptqueue add --command-template "claude -p {prompt}" 23:30 command review this repo
+```
+
+### `run`
+
+Start the queue worker:
+
+```powershell
+promptqueue run
+```
+
+Check once and exit:
+
+```powershell
+promptqueue run --once
+```
+
+Poll faster or slower:
+
+```powershell
+promptqueue run --poll 5
+```
+
+The runner must be alive when jobs are due.
+
+### `list`
+
+Show queued jobs:
+
+```powershell
+promptqueue list
+promptqueue list --all
+promptqueue list --full
+```
+
+### `show`
+
+Show one job as JSON:
+
+```powershell
+promptqueue show JOB_ID
+```
+
+### `remove`
+
+Delete one job:
+
+```powershell
+promptqueue remove JOB_ID
+```
+
+### `windows`
+
+List visible Windows window titles. Use this to find the right `--window` value.
+
+```powershell
+promptqueue windows
+```
+
+### `targets`
+
+List built-in target aliases:
+
+```powershell
+promptqueue targets
+```
+
+### `selftest`
+
+Run the built-in smoke test:
+
+```powershell
+promptqueue selftest
+```
+
+## Retries And History
+
+Every job stores attempts and history. Failures stay visible in `list` and `show`.
+
+```powershell
+promptqueue add --max-attempts 8 --retry-base 60 23:30 claude retry this more patiently
+promptqueue list --all
+promptqueue show JOB_ID
+```
+
+Backoff is exponential and capped at one hour.
+
+## Notes
+
+PromptQueue intentionally does the boring thing: it uses local files, the clipboard, app launching, and keyboard paste. That keeps it portable and inspectable.
+
+For GUI apps, it does not use private app APIs. If one app misses the composer, adjust `--window`, `--click`, `--delay`, or `--pre-keys`.
+
+## Contributing
+
+Issues and PRs are welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).
+
+The best contributions are small and practical: a better target alias, a failing selftest for a real bug, clearer setup docs, or a platform-specific paste improvement.
+
+## License
+
+MIT. See [LICENSE](LICENSE).
+
+Star the repo if it saves you from waiting around for an AI limit reset. That is the whole point.

promptqueue-0.1.0/README.md

@@ -0,0 +1,305 @@
+# PromptQueue
+
+[![CI](https://github.com/AtharvaMaik/PromptQueue/actions/workflows/ci.yml/badge.svg)](https://github.com/AtharvaMaik/PromptQueue/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
+[![PyPI](https://img.shields.io/pypi/v/promptqueue.svg)](https://pypi.org/project/promptqueue/)
+
+Schedule AI prompts for the moment your limits reset.
+
+PromptQueue is a tiny, dependency-free prompt scheduler for Claude, Codex, ChatGPT, Gemini, Copilot, Cursor, Antigravity, and anything else you can launch from your machine.
+
+When an AI tool says "try again at 7:30 PM", do not keep the tab open, set a reminder, or paste the same prompt later. Queue it now. PromptQueue waits, opens or focuses the target app, pastes the prompt, and submits it when the time arrives.
+
+```powershell
+promptqueue add 19:30 claude finish the migration plan
+promptqueue run
+```
+
+One Python file. Standard library only. No accounts, no server, no private APIs.
+
+![PromptQueue terminal demo](https://raw.githubusercontent.com/AtharvaMaik/PromptQueue/main/docs/demo.svg)
+
+## Why This Exists
+
+AI rate limits waste the worst kind of time: attention.
+
+You already know what you want to ask next. The only problem is the clock. PromptQueue turns "come back later" into a queued job you can trust.
+
+Use it when:
+
+- Claude, Codex, ChatGPT, Gemini, or Copilot tells you to wait for a reset
+- you want a long prompt to run after you sleep
+- you want a coding agent to resume work when capacity returns
+- you want a dead-simple local queue instead of another SaaS dashboard
+
+If this saves you one context switch, it has already done its job.
+
+## 30 Second Demo
+
+Queue a Claude prompt for 11:30 PM:
+
+```powershell
+promptqueue add 23:30 claude write a first draft of the launch email
+promptqueue run
+```
+
+Queue a Codex CLI prompt:
+
+```powershell
+promptqueue add 23:30 codex-exec add tests for the queue runner
+promptqueue run
+```
+
+Queue a multiline prompt safely:
+
+```powershell
+@'
+Review this repo.
+Find the smallest useful next improvement.
+Then implement it.
+'@ | promptqueue add --stdin 23:30 claude
+promptqueue run
+```
+
+View what is waiting:
+
+```powershell
+promptqueue list --full
+promptqueue show JOB_ID
+```
+
+## Supported Targets
+
+```text
+antigravity  Google Antigravity UI
+chatgpt      ChatGPT web UI
+claude       Claude web UI
+claude-code  Claude CLI
+codex        Codex desktop UI
+codex-exec   Codex CLI
+copilot      Copilot web UI
+copy         clipboard only
+cursor       Cursor UI
+gemini       Gemini web UI
+```
+
+Run this to see the built-in aliases on your machine:
+
+```powershell
+promptqueue targets
+```
+
+UI targets open or focus the app, click near the composer, paste, then press Enter by default.
+
+CLI targets run the command directly with the prompt as one argument.
+
+## Agent Ready
+
+This repo includes instruction files for common AI coding tools:
+
+```text
+AGENTS.md                         Codex and general agents
+CLAUDE.md                         Claude Code
+GEMINI.md                         Gemini CLI
+.cursor/rules/promptqueue.mdc     Cursor
+.agents/skills/promptqueue/       Antigravity-style skill
+```
+
+That means you can tell an agent:
+
+```text
+My limits reset at 7:30 pm. Schedule this prompt for Claude:
+"Continue the refactor and run the tests."
+```
+
+The agent should queue it with PromptQueue instead of making you remember.
+
+## Requirements
+
+- Python 3.10+
+- Windows for GUI paste/submit automation
+- macOS/Linux work for queue management, URLs, clipboard fallback, and CLI targets, but GUI paste currently uses Windows APIs
+
+## Install
+
+Install from PyPI:
+
+```powershell
+pip install promptqueue
+promptqueue selftest
+```
+
+Or clone the repo and run the single Python file:
+
+```powershell
+git clone https://github.com/AtharvaMaik/PromptQueue.git
+cd PromptQueue
+python promptqueue.py selftest
+```
+
+After `pip install`, use `promptqueue`. When running from a clone without installing, use `python promptqueue.py`.
+
+PromptQueue stores jobs in:
+
+```text
+%USERPROFILE%\.promptqueue.json
+```
+
+Override the queue path when you want an isolated queue:
+
+```powershell
+$env:PROMPTQUEUE_FILE="C:\path\queue.json"
+```
+
+## How It Works
+
+1. `add` writes a job to the local queue file.
+2. `run` checks for due jobs.
+3. When a job is due, PromptQueue copies the prompt to the clipboard.
+4. For UI targets, it opens or focuses the app, clicks the composer, pastes, and optionally submits.
+5. For CLI targets, it launches the command directly.
+6. Attempts, failures, retries, and history stay visible in the queue file.
+
+If the machine wakes up after the scheduled time, `run` catches overdue jobs.
+
+## Commands
+
+### `add`
+
+Queue a prompt.
+
+```powershell
+promptqueue add [options] WHEN TARGET PROMPT...
+```
+
+`WHEN` can be a local time like `23:30` or an ISO-ish datetime like `2026-06-24 01:15`.
+
+Options:
+
+```text
+--click bottom                 Click near the bottom of the focused window before paste.
+--click x,y                    Click x/y pixels from the target window top-left.
+--command-template TEMPLATE    Run a custom command; use {prompt}.
+--delay SECONDS                Wait before paste/submit. Default: 5.
+--file FILE                    Read prompt text from a UTF-8 file.
+--max-attempts N               Attempts before marking failed. Default: 5.
+--no-submit                    Paste only; do not press Enter.
+--pre-keys KEYS                Windows SendKeys before paste, e.g. "{ESC}".
+--retry-base SECONDS           Initial retry delay. Default: 30.
+--stdin                        Read prompt text from stdin.
+--window TITLE                 Focus a window whose title contains TITLE.
+```
+
+Examples:
+
+```powershell
+promptqueue add 23:30 claude summarize this paper
+promptqueue add --window Codex 23:30 copy this lands in Codex
+promptqueue add --no-submit 23:30 claude paste this but do not send it
+promptqueue add --file prompt.txt 23:30 claude
+"prompt from stdin" | promptqueue add --stdin 23:30 copy
+promptqueue add --command-template "claude -p {prompt}" 23:30 command review this repo
+```
+
+### `run`
+
+Start the queue worker:
+
+```powershell
+promptqueue run
+```
+
+Check once and exit:
+
+```powershell
+promptqueue run --once
+```
+
+Poll faster or slower:
+
+```powershell
+promptqueue run --poll 5
+```
+
+The runner must be alive when jobs are due.
+
+### `list`
+
+Show queued jobs:
+
+```powershell
+promptqueue list
+promptqueue list --all
+promptqueue list --full
+```
+
+### `show`
+
+Show one job as JSON:
+
+```powershell
+promptqueue show JOB_ID
+```
+
+### `remove`
+
+Delete one job:
+
+```powershell
+promptqueue remove JOB_ID
+```
+
+### `windows`
+
+List visible Windows window titles. Use this to find the right `--window` value.
+
+```powershell
+promptqueue windows
+```
+
+### `targets`
+
+List built-in target aliases:
+
+```powershell
+promptqueue targets
+```
+
+### `selftest`
+
+Run the built-in smoke test:
+
+```powershell
+promptqueue selftest
+```
+
+## Retries And History
+
+Every job stores attempts and history. Failures stay visible in `list` and `show`.
+
+```powershell
+promptqueue add --max-attempts 8 --retry-base 60 23:30 claude retry this more patiently
+promptqueue list --all
+promptqueue show JOB_ID
+```
+
+Backoff is exponential and capped at one hour.
+
+## Notes
+
+PromptQueue intentionally does the boring thing: it uses local files, the clipboard, app launching, and keyboard paste. That keeps it portable and inspectable.
+
+For GUI apps, it does not use private app APIs. If one app misses the composer, adjust `--window`, `--click`, `--delay`, or `--pre-keys`.
+
+## Contributing
+
+Issues and PRs are welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).
+
+The best contributions are small and practical: a better target alias, a failing selftest for a real bug, clearer setup docs, or a platform-specific paste improvement.
+
+## License
+
+MIT. See [LICENSE](LICENSE).
+
+Star the repo if it saves you from waiting around for an AI limit reset. That is the whole point.