Override settings for one project

Make one repository use different Mistral settings than your machine-wide defaults — for example, a project agent id or a project region. You need this when a repo’s workflow requires its own configuration.

Prerequisites

• The pi-mistral-native package installed
• The project must be trusted in pi (pi loads the project file only for trusted projects)

1. Write the key to the project scope from inside the project directory:

   /mistral set --project agentId my-agent

   The write goes to <cwd>/.pi/mistral-native.json. Without --project the write targets your user scope instead.

2. Verify the change:

   /mistral

   The key shows its new value with project file provenance.

3. Commit the file, so every contributor of the repository sees the same override in review.

Project wins, trust gates the file

A project-scope key outranks both your user file and environment variables — in this project. A project region also wins over the /login region picker’s user-scope write, so in a project that sets its own region the login selection appears ineffective. An untrusted project’s file is ignored entirely, and /mistral set --project refuses to write with an error naming the trust requirement.

See How configuration layers work · Config file locations and precedence · /mistral commands