| name | regular-ping |
| description | Set up, inspect, retarget, pause, or resume recurring tmux pings ("regular pings") using `t jobs`. Use when the user asks to create a scheduled ping for a session, check existing pings, or move a ping to another tmux session. |
| allowed-tools | Bash(t *), Bash(tmux *) |
Regular Ping
In this environment, a "regular ping" means a recurring ping managed through t jobs.
Find the right tmux session
If the user only knows the recent-session ID, resolve it first:
t
t list
If the agent is already inside the target tmux session, :current is valid for job commands:
t jobs add :current --every 20m --message "..."
t jobs edit <job-id> --session :current
If multiple similar sessions exist, inspect them before attaching the ping to the wrong one:
tmux list-panes -t <session> -F '#{session_name}:#{window_index}.#{pane_index}:#{pane_current_command}:#{pane_title}:#{pane_active}'
Always prefer the exact tmux session name over a guessed prefix.
Get existing regular pings
List all jobs:
t j
List jobs for one session:
t jobs list --session <session>
Inspect one job:
t jobs show <job-id>
Check recent delivery logs:
t jobs logs --limit 20
Notes:
t j is shorthand for t jobs
- job IDs are not session IDs
- if a job is attached to the wrong session, retarget it with
t jobs edit
Set up a new regular ping
For a short inline prompt:
t jobs add <session> --every 20m --message "Continue until all issues are resolved."
For a longer prompt:
t jobs add <session> --every 20m --message-file prompts/<name>.txt
After creating the job, verify it:
t jobs list --session <session>
t jobs show <job-id>
If the user wants an immediate one-off message right now, send it separately:
t send <session> --message "..."
Update or fix an existing regular ping
Retarget a job to the correct session:
t jobs edit <job-id> --session <session>
Change interval or prompt:
t jobs edit <job-id> --every 30m
t jobs edit <job-id> --message "..."
Pause or resume one job:
t jobs pause <job-id>
t jobs resume <job-id>
Pause or resume all jobs for the current tmux session:
t jobs pause-current
t jobs resume-current
Remove a job that is no longer needed:
t jobs remove <job-id>
Practical rules
- Verify the target session before creating or moving a job.
- Use the exact session name when multiple similar sessions exist.
- Confirm the result with
t jobs show <job-id> after changes.
- If the user says "start now", that is separate from regular scheduling; send a one-off message with
t send.