kunchenguid compact-adviser settings
compact-adviser watches for a completed checkpoint and prints one hint to run /compact.
It cannot run /compact itself: Codex exposes no way for an outside process to do that, so
this host is hint-only and there is no automatic mode. Never claim otherwise.
How to run it
Settings live in a small CLI inside this plugin. From the directory that holds this
SKILL.md, the CLI is at ../../src/cli.ts; run it with the absolute path:
node "<this skill's directory>/../../src/cli.ts" <command>
macOS or Linux and Node 22.18 or newer are required, because the CLI is TypeScript that Node strips types from and the hooks run through POSIX sh.
Commands
| Command | Effect |
|---|---|
status |
Mode, minimum, key source, the latest session's cooldown, and the request-log path |
hint |
Advise with a hint at eligible checkpoints (the default) |
off |
Stop advising; Codex's own compaction is unaffected |
threshold <tokens|default> |
Save an absolute token minimum |
log <on|off> |
Log each TypeSafe request and its outcome to a local jsonl file |
key set |
Prompt for a TypeSafe API key and save it; the value is never printed |
key clear / key status |
Remove the saved key, or report which source the key in effect came from |
key set reads the key from the terminal, so ask the user to run that one themselves rather
than passing a key on a command line. Never print, echo, or repeat a key value.