# Loops

> Show a unified view of Claude Code cron/loop state — currently active cron jobs, currently paused loops (from /loop-pause), and recent loop history (last starts/pauses/resumes/stops). Use this to check what's running or recently ran.

- Skill: `thepictishbeast/loops` (Agent Skill)
- Install (CLI): `npx skillmds@latest add thepictishbeast/loops`
- Raw SKILL.md: https://api.skillmd.com/api/skills/thepictishbeast/loops/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: thepictishbeast (https://skillmd.com/u/thepictishbeast)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/thepictishbeast/loops

---


# /loops — list active + paused + recent loop activity

Thin wrapper around `claude-loop list`. Binary owns file reads +
JSON shaping. Agent does the CronList API call.

## Steps

1. **Active jobs** — call `CronList`, render the output.

2. **Paused + recent history** — invoke the binary:

   ```sh
   claude-loop list
   ```

   Stdout is JSON with `paused` (array of paused-job records) +
   `history_tail` (last 20 lines of `loop-history.jsonl`).

3. **Render compactly**:

   ```
   Active (N):
     <id> · <cadence_human> · <prompt first 60 chars>...

   Paused (M):
     · cron=<expr> · paused at <ISO>: <prompt first 60 chars>...
     (run /loop-resume to restore)

   Recent history (latest first):
     <ISO>  <event>  <id>  <prompt first 40 chars>...
   ```

   If active + paused + history are ALL empty: "No loops active,
   paused, or in history yet. Use /loop to schedule one."

## Optional argument: `/loops history [N]`

For just the history tail:

```sh
claude-loop history -n 50
```

Default N = 20.

## Optional argument: `/loops clear-history`

Not wired into the binary (destructive ops kept out of the
auto-callable path). Suggest `rm ~/.claude/loop-history.jsonl` if
the user really wants to truncate.

## Net visible tool calls per /loops

**2** total: `CronList` + `Bash`(claude-loop list).

## Don't

- Don't modify state files. This skill is strictly read-only.
- Don't call CronCreate / CronDelete here — those belong to
  /loop-resume / /loop-pause.