Credentials. The TypeSafe API key is kept in the launch environment, saved settings, or a .env file, and eligible checkpoint context is sent to TypeSafe once a key is available.
Who it is forA developer working in a long Pi coding session whose context keeps growing and who wants to know when compacting is safe.
The problemLong sessions carry more context every turn, and compacting at the wrong moment can lose useful working state.
The outcomePi shows a hint to run /compact when a turn looks finished and the context is large enough, or compacts on its own in auto mode after first-use confirmation.
What you need first
- Node 22 or newer (22.18 or newer for Codex and Grok)
- One supported host: Pi 0.82.0 or newer, Claude Code 2.1.274 or newer, Codex CLI 0.153.0 or newer, or Grok Build 1.0.34 or newer
- A TypeSafe API key, supplied as TYPESAFE_API_KEY in the launch environment, a cwd .env file, or saved through the host settings where supported
Steps
- Confirm Node 22 or newer is installed and that Pi is version 0.82.0 or newer.
- Run
pi install npm:compact-adviser. - Provide your TypeSafe key with TYPESAFE_API_KEY in the launch environment, or save it through the /compact-adviser settings.
- Restart Pi or run
/reload, then run/compact-adviser statusand confirm it showsKey: env,Key: saved, orKey: .env. - Run
/compact-adviser hintfor suggestions only, or/compact-adviser autoto allow automatic compaction after the first-use confirmation. (inferred, check the README)
Prompt for your agent
Install the compact-adviser package in Pi on <target machine>: run `pi install npm:compact-adviser`, set TYPESAFE_API_KEY, then run `/compact-adviser status`. Expected output: a status line reporting a key source of env, saved, or .env. Verify that the key source is not missing before reporting success.
Caveat. Pi is only one of four hosts, and the README says the install counts as consent to send eligible checkpoint context to TypeSafe.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Disclaimer
Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked "Seen in the wild", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email [email protected] and we will look at it promptly. Full disclaimer page