pi-model-config

Configure Pi model defaults, session overrides, and cycling lists.

17|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/ivanrvpereira/.agents --skill pi-model-config
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pi-model-config
Source: https://github.com/ivanrvpereira/.agents/tree/main/.pi/skills/pi-model-config
Command: npx skills add https://github.com/ivanrvpereira/.agents --skill pi-model-config

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you understand and update how Pi chooses its default and session models so you can get consistent results without guessing providers, thinking levels, or shortcut behaviors.

Core Features & Use Cases

  • Default model configuration: Update the repo’s Pi settings for provider, model, and default thinking level.
  • One-off/session model switching: Use Pi commands to change the active model for the current interactive session.
  • Ctrl+P scoped model cycling: Control the ordered list of enabled models used by Pi’s Ctrl+P and Shift+Ctrl+Ctrl+P cycling.
  • Prompt-editor mode presets: Maintain the prompt-editor mode mapping in modes.json so model/preset behavior matches your workflow.

Quick Start

Ask the AI to update your Pi default model and thinking level to the specific provider/model you want, and confirm whether you should run bin/sync or use /reload after the edit.

Frequently Asked Questions about pi-model-config

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure the default Pi model and thinking level for my project?▼

To configure Pi model defaults, update the provider, model, and default thinking level in the repo's pi/settings.json file. You should validate the chosen model ID using pi --list-models before applying changes to ensure consistent AI behavior.

How does Ctrl+P scoped model cycling work in Pi?▼

Ctrl+P scoped model cycling uses an ordered list of enabled models defined in your Pi settings. You control this sequence by updating the configuration to include the specific models available for cycling during your session.

Can I switch the active Pi model for just the current session?▼

Yes, you can switch the active model for the current interactive session using Pi commands. This creates a per-session override without permanently altering the repo's persistent default model configuration in pi/settings.json.

What is the best way to update prompt-editor mode presets in Pi?▼

The best way to update prompt-editor mode presets is to maintain the mappings in the optional ~/.pi/agent/modes.json file. This ensures the prompt-editor mode behavior accurately aligns with your specific model and preset workflow.

Will changing Pi provider settings affect my other configuration files?▼

No, changing Pi provider settings safely preserves unrelated configuration. The process requires inspecting pi/settings.json, applying model updates, and keeping the exact ordering of existing settings exactly as originally requested without disrupting other data.