@specode/pi-last-model-effort

Remember the last thinking effort used by each model in Pi.

Packages

Package details

extension

Install @specode/pi-last-model-effort from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@specode/pi-last-model-effort
Package
@specode/pi-last-model-effort
Version
1.0.3
Published
Oct 31, 2026
Downloads
553/mo · 243/wk
Author
specode
License
MIT
Types
extension
Size
30.8 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-last-model-effort

English | 简体中文

A Pi extension that remembers the thinking effort you last used for each model and restores the last active model and effort in new TUI sessions.

Installation

Requires a Pi version that exposes ExtensionContext.mode (tested with Pi 1.4.0).

From npm:

pi install npm:@specode/pi-last-model-effort

From GitHub:

pi install git:github.com/specode/pi-last-model-effort

From a local directory for development:

pi install /path/to/pi-last-model-effort

Restart Pi after installing.

Usage

No configuration is needed. Once installed:

  • Changing the thinking effort on a model saves that level for that provider/model.
  • Switching to another model and back restores each model's saved thinking effort.
  • Starting a fresh pi TUI session or running /new restores the most recently selected model and its saved effort.
  • If a saved effort is outside what the target model supports, Pi clamps it through setThinkingLevel() and saves the resulting level.

Session Precedence

Scenario Behavior
Fresh TUI pi session or /new Restores the last selected model and its saved effort
Switch or cycle models in-session Restores the saved effort for the selected model
pi -c, /resume, fork, clone, /reload Keeps the session's existing model and effort
CLI flags (--model, --provider, --thinking, --models with :thinking) CLI flags take precedence
Scoped model (--models / enabledModels) with pinned effort Pinned effort takes precedence
Non-TUI modes (rpc, json, print) or PI_SUBAGENT_CHILD=1 Ignored; does not read, restore, or write state
Saved model unavailable or missing credentials Keeps Pi's current selection and shows a warning

Configuration

State is stored in ~/.pi/agent/state/last-model-effort.json (following Pi's agent directory). Set PI_LAST_MODEL_EFFORT_STATE to override the state file path in tests or isolated environments.

Privacy and Safety

  • Makes no network requests and reads no credentials.
  • Does not modify settings.json, modelThinkingLevels, or session files.
  • Runs only when ctx.mode === "tui" and ignores PI_SUBAGENT_CHILD=1 subprocesses so non-interactive or subagent runs never overwrite your preferences.
  • Uses file locking, timestamp merging, and atomic writes (0600) so multiple Pi terminals can run at the same time without corrupting state.

Development

# Run tests (requires Node.js with native TypeScript support)
npm test

# Check package contents
npm run pack:check

# Load the extension directly in Pi without installing
pi --no-extensions --offline -e ./src/index.ts --list-models

License

MIT.