diff options
Diffstat (limited to 'prompts/skills/continue-reminder/SKILL.md')
| -rw-r--r-- | prompts/skills/continue-reminder/SKILL.md | 99 |
1 files changed, 99 insertions, 0 deletions
diff --git a/prompts/skills/continue-reminder/SKILL.md b/prompts/skills/continue-reminder/SKILL.md new file mode 100644 index 0000000..b927a31 --- /dev/null +++ b/prompts/skills/continue-reminder/SKILL.md @@ -0,0 +1,99 @@ +--- +name: continue-reminder +description: Resume a paused coding-agent session after a rate limit, cooldown, or scheduled break by using systemd user timers to send keystrokes to the correct tmux pane. Supports Claude, Codex, OpenCode, and AMP agents. +--- + +# Continue Reminder via Systemd + +Use this skill when a coding agent running inside a tmux pane gets paused (rate-limited, user-throttled, or intentionally interrupted) and you want to **automatically resume** it at a known future time using systemd user timers and services. + +## When to Use + +- You hit a rate limit in a coding agent (e.g., Claude Code "session limit") +- You need to schedule a delayed `continue` or equivalent command +- The agent lives in a tmux pane and accepts keyboard input to resume +- You want the resume to happen automatically even if you step away +- You support multiple coding agents (Claude, Codex, OpenCode, ampcode) and need per-agent specifics + +## How It Works + +1. **Inspect** the tmux pane where the agent is blocked. +2. **Note** the reset time / condition. +3. **Create** a systemd user timer that triggers at (or after) that time. +4. **Create** a oneshot service that runs a script sending the right keystrokes to the tmux pane. +5. **Enable** the timer; systemd wakes up and resumes the session automatically. + +## Reference Files + +Each coding agent has its own quirks (prompt text, resume command, key sequences). See the agent-specific sub-references below: + +- [Claude](references/claude.md) — Claude Code CLI in tmux, rate-limit screen, `continue` +- [Codex](references/codex.md) — Placeholder for Codex CLI specifics +- [OpenCode](references/opencode.md) — Placeholder for OpenCode Agent specifics +- [ampcode](references/amp.md) — Placeholder for ampcode agent specifics + +## Common Ingredients + +These pieces are reused across all agent implementations: + +| Component | Typical Path / Value | +|-----------|---------------------| +| TMUX socket | `/tmp/tmux-$(id -u)/default` | +| Script dir | `~/.local/bin/` | +| Service dir | `~/.config/systemd/user/` | +| Timer type | `OnCalendar` for wall-clock triggers | +| Service type | `oneshot` | + +### Skeleton Script + +```bash +#!/bin/bash +set -euo pipefail + +TMUX_SOCKET="/tmp/tmux-$(id -u)/default" +TARGET="<session>:<window>.<pane>" + +# 1) Acknowledge / select "stop and wait" +tmux -S "$TMUX_SOCKET" send-keys -t "$TARGET" Enter + +# 2) Sleep past the reset window +sleep <buffer_seconds> + +# 3) Send resume command +tmux -S "$TMUX_SOCKET" send-keys -t "$TARGET" "<resume_command>" Enter +``` + +### Skeleton Service + +```ini +[Unit] +Description=Resume <agent> in tmux pane + +[Service] +Type=oneshot +ExecStart=%h/.local/bin/<script>.sh +Environment="PATH=/usr/local/bin:/usr/bin:/bin" +``` + +### Skeleton Timer + +```ini +[Unit] +Description=One-off timer for <agent> tmux resume + +[Timer] +OnCalendar=<ISO_datetime> +AccuracySec=1s +Persistent=false + +[Install] +WantedBy=timers.target +``` + +### Enable / Check + +```bash +systemctl --user daemon-reload +systemctl --user enable --now <timer>.timer +systemctl --user status <timer>.timer +``` |