---
slug: "kim05-pi-autoprompt"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/05kim/pi-autoprompt@main/README.md"
repo: "https://github.com/05kim/pi-autoprompt"
source_file: "README.md"
branch: "main"
---
# pi-autoprompt

English | [한국어](https://github.com/05kim/pi-autoprompt/blob/HEAD/README.ko.md)

pi-autoprompt makes Pi include direct goal-continuation follow-up task candidates in the final assistant response, then lets you select one after the session turn ends or automatically continues after a timeout. It does not make an extra LLM call. If there is no useful immediate follow-up work, it stops.

## Commands

```text
/autoprompt on                 # Enable automatic follow-up execution and loop mode
/autoprompt off                # Disable automatic follow-up execution for the current runtime
/autoprompt now                # Run autoprompt once now
/autoprompt status             # Show current status (default timeout=10s)
/autoprompt timeout 15         # Set selection timeout in seconds
/autoprompt loop on            # Enable continuous follow-up execution
/autoprompt loop off           # Disable continuous follow-up execution for the current runtime
/autoprompt mode normal        # Suggest practical follow-ups that continue the current goal
/autoprompt mode conservative  # Suggest only follow-ups required to finish the explicit request
/autoprompt cancel             # Cancel the pending automatic follow-up
/autoprompt history            # Show recent automatic follow-up history
/autoprompt help               # Show command help
/autoprompt doctor             # Show cache decision / usage debug info
/autoprompt reset-stats        # Reset cache statistics
```

## Loop

Autoprompt and loop mode are default-on after startup/reload. After an autoprompt follow-up finishes, if the final response contains more goal-continuation follow-up candidates, pi-autoprompt keeps sending the next selected candidate.

The current loop stops automatically when there is no useful immediate follow-up task.

If `cacheRead` is missing or the prompt cache hit rate is below 50%, pi-autoprompt shows a warning but keeps the loop running while follow-up candidates exist.

When there is no useful immediate follow-up task, pi-autoprompt stops the current loop but keeps the saved loop setting enabled for future turns.

## Doctor

`/autoprompt doctor` shows cache debugging values in one report:

- `currentCacheKey`, `sessionId`
- `lastRawUsage`
- Extracted `cacheRead`, `cacheWrite`, `totalInputTokens`
- `cacheHitRate`
- Hints for possible causes when `cacheRead=0`

## Persisted settings

The following values are stored under `piAutoprompt` in Pi's global `settings.json`, so they survive `/reload`:

- `timeoutSeconds`
- `mode`
- `history`

`enabled` and `loopEnabled` are intentionally default-on after startup/reload. Use `/autoprompt off` or `/autoprompt loop off` to disable them for the current runtime.

## Cost note

`loop on` can keep the coding agent running through multiple follow-up tasks. Turn it off with `/autoprompt loop off` when needed.