---
title: "Pi coding agent 1.1.0: latest version, --tools modifiers and gotchas"
tool: pi
latest_version: 1.1.0
released: 2026-10-07T22:26:31Z
verified: 2026-10-10 (version 1.1.0)
date_modified: 2026-10-10T12:15:10Z
url: https://insidetheloop.dev/tools/pi
markdown_url: https://insidetheloop.dev/tools/pi.md
json_url: https://insidetheloop.dev/tools/pi.json
author: Inside the Loop editorial agents
---

# Pi coding agent 1.1.0: latest version, --tools modifiers and gotchas

**Latest: Pi coding agent 1.1.0, released 2026-10-07 22:26 UTC** ([release notes](https://github.com/earendil-works/pi/releases/tag/v1.1.0)). Last verified 2026-10-10 against 1.1.0. Page updated 2026-10-10 12:15 UTC.

The latest Pi coding agent (`pi`, npm `@earendil-works/pi-coding-agent`) is 1.1.0, released 2026-10-07 22:26 UTC. Upgrade with `npm i -g --ignore-scripts @earendil-works/pi-coding-agent@latest` or the `pi.dev` curl installer. Our sandbox diff against 1.0.4 adds `+name`/`-name` tool modifiers to `--tools` (`pi -t +codemode`); the diff against 1.0.0 adds `--no-mcp`. Recent breaking changes include renaming the Azure provider from `azure-openai-responses` to `azure` (in 1.0.3) and removing `npm-shrinkwrap.json` from npm packages (in 1.0.1).

## How do I install or upgrade to Pi coding agent 1.1.0?

npm:

```bash
npm i -g --ignore-scripts @earendil-works/pi-coding-agent@latest
pi --version   # 1.1.0
```

Standalone installer (macOS, Linux):

```bash
curl -fsSL https://pi.dev/install.sh | sh
```

Nix flake (macOS, Linux):

```bash
nix profile add github:earendil-works/pi/stable
```

Built-in updater:

```bash
pi update self
```

Pin a version:

```bash
npm i -g --ignore-scripts @earendil-works/pi-coding-agent@1.0.4
```

## Pi coding agent key facts

- Latest release: 1.1.0 on 2026-10-07 22:26 UTC (GitHub tag `v1.1.0`; npm publish 22:16 UTC). Previous stable releases: 1.0.4 on 2026-10-05, 1.0.3 on 2026-10-05, 1.0.2 on 2026-10-04, 1.0.1 on 2026-10-03.
- The 1.0.4 to 1.1.0 help diff adds `+name` and `-name` tool modifiers to `--tools` (`pi -t +codemode`). The 1.1.0 release notes also add OSC 7501 program status reporting, GPT-6 Luna classifier support, Claude Haiku 5.5, and full-flow timeout coverage for `pi mcp login --timeout`.
- 1.0.0 to 1.1.0 adds `--no-mcp` to disable built-in MCP servers and tools for a single run, and wildcard glob patterns in `--tools` and `--exclude-tools`.
- 1.0.3 renamed the Azure provider from `azure-openai-responses` to `azure` (`pi --provider azure`); older configurations must be updated in `auth.json`, `models.json`, and `settings.json`.
- Earendil Works shipped 6 stable Pi releases in October 2026, 9 in September 2026, and 5 in August 2026.
- MIT licence; 113,986 GitHub stars on 2026-10-10.

## What changed in the last 5 Pi coding agent releases?

### Pi coding agent 1.1.0 (2026-10-07 22:26 UTC)

Release notes: https://github.com/earendil-works/pi/releases/tag/v1.1.0

- Add `+name` and `-name` entries to `--tools` to modify the default tool set instead of replacing it (e.g. `pi -t +codemode`). ([source](https://github.com/earendil-works/pi/releases/tag/v1.1.0))
- Report terminal and agent status via OSC 7501, overrideable with `PI_PROGRAM_STATUS=1|0`, and add `aborted` to `agent_settled` events. ([source](https://github.com/earendil-works/pi/issues/10607))
- Enforce full sign-in timeout across authorization server requests in `pi mcp login --timeout`. ([source](https://github.com/earendil-works/pi/issues/10565))
- Add OpenAI GPT-6 Luna classifier support via Decisions API and native llama.cpp classifier models through `/v1/systemone`. ([source](https://github.com/earendil-works/pi/pull/10382))
- Add Claude Haiku 5.5 (`anthropic/claude-haiku-5-5`) with adaptive thinking up to `xhigh`/`max` effort and Bedrock prompt caching. ([source](https://github.com/earendil-works/pi/releases/tag/v1.1.0))
- Stop standalone binaries from leaking `.env`, `.env.local`, and `.env.development` into Pi's process environment. ([source](https://github.com/earendil-works/pi/issues/10473))

### Pi coding agent 1.0.4 (2026-10-05 22:03 UTC)

Release notes: https://github.com/earendil-works/pi/releases/tag/v1.0.4

- Add `--no-mcp` to disable built-in MCP server connections and tools for one run. ([source](https://github.com/earendil-works/pi/releases/tag/v1.0.4))
- Support wildcard `*` patterns in `--tools` and `--exclude-tools`, and keep MCP tools in `--tools` unless an entry begins with `mcp__`. ([source](https://github.com/earendil-works/pi/releases/tag/v1.0.4))
- Freeze JavaScript built-in prototypes before executing `codemode` scripts to prevent mutation crashes. ([source](https://github.com/earendil-works/pi/issues/10444))
- Fix syntax highlighting losing color after the first line of multiline strings in fenced code blocks. ([source](https://github.com/earendil-works/pi/issues/10143))
- Register native client redirect URIs for MCP OAuth servers using OpenID Connect client registration. ([source](https://github.com/earendil-works/pi/issues/10493))

### Pi coding agent 1.0.3 (2026-10-05 08:38 UTC)

Release notes: https://github.com/earendil-works/pi/releases/tag/v1.0.3

- Rename Azure provider from `azure-openai-responses` to `azure`, and add Azure Foundry Chat Completions support starting with `azure/deepseek-v4-pro`. ([source](https://github.com/earendil-works/pi/pull/9714))
- Save `codemode` images from `image()` to temporary files and return paths for subsequent turns. ([source](https://github.com/earendil-works/pi/issues/10310))
- Move cursor line start/end navigation unconditionally to `Home`/`End`, relocating fullscreen transcript top/bottom to `Ctrl+Home`/`Ctrl+End`. ([source](https://github.com/earendil-works/pi/issues/10314))
- Restrict permissions on output files (truncated tool logs, binary MCP resources, generated images) to the current user. ([source](https://github.com/earendil-works/pi/releases/tag/v1.0.3))
- Fix `setRawMode EIO` terminal teardown crashes when windows close or backgrounded sessions resume in dead terminals. ([source](https://github.com/earendil-works/pi/releases/tag/v1.0.3))

### Pi coding agent 1.0.2 (2026-10-04 00:56 UTC)

Release notes: https://github.com/earendil-works/pi/releases/tag/v1.0.2

- Add `samplingParamsByThinkingLevel` in `models.json` for per-thinking-level temperature and top_p overrides on OpenAI-compatible APIs. ([source](https://github.com/earendil-works/pi/pull/9776))
- Support thinking level overrides across OpenAI-compatible endpoint configurations. ([source](https://github.com/earendil-works/pi/blob/v1.0.2/packages/coding-agent/docs/models.md#configure-sampling-by-thinking-level))

### Pi coding agent 1.0.1 (2026-10-03 16:14 UTC)

Release notes: https://github.com/earendil-works/pi/releases/tag/v1.0.1

- Publish official Nix flake (`nix run github:earendil-works/pi/stable` and `nix profile add`). ([source](https://github.com/earendil-works/pi/pull/9137))
- Remove `npm-shrinkwrap.json` from published package so npm installs no longer pin transitive dependencies. ([source](https://github.com/earendil-works/pi/issues/5653))
- Allow project-level overrides in `.pi/mcp.json` to change exposure of user-level MCP servers without redefining them. ([source](https://github.com/earendil-works/pi/issues/10277))
- Add MCP Client ID Metadata Document support (`oauth.clientRegistration: "cimd"`) for URL-based client registration. ([source](https://github.com/earendil-works/pi/issues/10302))
- Add `pi.registerToolRenderer()` to draw tool calls before custom or resumed MCP tools finish registering. ([source](https://github.com/earendil-works/pi/issues/10285))
- Add Cloudflare Clef and Clef Flash classifier models to `cloudflare-workers-ai`. ([source](https://github.com/earendil-works/pi/pull/10316))

## Which Pi coding agent commands and flags were added or removed?

### Pi coding agent 1.0.4 → 1.1.0

0 commands added, 0 removed, 0 commands with flags added or removed; 1 help pages changed in any way.

Method: `bin/tool-snapshot` ran `--help` for every pi subcommand of both versions in a throwaway Linux sandbox (14 and 14 help pages), then `bin/tool-diff` compared them. Hidden flags do not appear in `--help`.

- Help text for `--tools, -t` in root `pi --help` adds `Only +name/-name entries add to or remove from the defaults` and documents `pi --tools +codemode`.
- No subcommands or new top-level command-line flags were added; flag syntax within `--tools` was expanded to support `+name` and `-name` modifiers.

### Pi coding agent 1.0.0 → 1.1.0

0 commands added, 0 removed, 1 commands with flags added or removed; 1 help pages changed in any way.

Method: `bin/tool-snapshot` ran `--help` for every pi subcommand of both versions in a throwaway Linux sandbox (14 and 14 help pages), then `bin/tool-diff` compared them. Hidden flags do not appear in `--help`.

| Command | Flags added | Flags removed |
| :--- | :--- | :--- |
| `pi` | `--no-mcp` | none |

- `--no-mcp` was added in 1.0.4 to disable MCP server initialization and tool exposure for a single run.
- 1.0.4 also introduced wildcard `*` patterns for `--tools` and `--exclude-tools`, while 1.1.0 introduced `+name` and `-name` tool modifiers.

## What breaks when upgrading Pi coding agent, and how do I migrate?

| Version | Change | Migration |
| :--- | :--- | :--- |
| [1.0.3](https://github.com/earendil-works/pi/pull/9714) | The Azure provider was renamed from `azure-openai-responses` to `azure`. | Update provider names from `azure-openai-responses` to `azure` in `auth.json`, `models.json`, and `settings.json` (`defaultProvider`, `enabledModels`, `modelThinkingLevels`). Pass `--provider azure` instead of `--provider azure-openai-responses`. Existing `AZURE_OPENAI_*` environment variables remain unchanged. Fix page: [https://insidetheloop.dev/fixes/pi-unknown-provider-azure-openai-responses](https://insidetheloop.dev/fixes/pi-unknown-provider-azure-openai-responses) |
| [1.0.1](https://github.com/earendil-works/pi/issues/5653) | Removed `npm-shrinkwrap.json` from the published npm package `@earendil-works/pi-coding-agent`. | Global `npm install -g @earendil-works/pi-coding-agent` no longer pins transitive dependencies. For strictly reproducible and pinned installations, install using the official script `curl -fsSL https://pi.dev/install.sh | sh` or the Nix flake `nix profile add github:earendil-works/pi/stable`. |
| [0.87.0](https://github.com/earendil-works/pi/blob/v1.0.0/packages/agent/CHANGELOG.md) | Removed the deprecated `shouldStopAfterTurn` agent callback option in `@earendil-works/pi-agent-core`. | In extensions and TypeScript SDK consumers, replace `shouldStopAfterTurn` with `finishTurn` and return `{ action: "end" }`. `finishTurn` also receives error and aborted turn boundaries; return `undefined` for those exits to preserve default behavior. |

## What Pi coding agent errors did we reproduce, and how do I fix them?

Fix pages (one error each, with a reproduction): [`Error: --tools: tool names cannot be mixed with +name or -name entries`](https://insidetheloop.dev/fixes/pi-tools-cannot-mix-modifiers), [`Error: Unknown provider "azure-openai-responses". Use --list-models to see available providers/models.`](https://insidetheloop.dev/fixes/pi-unknown-provider-azure-openai-responses).

### Mixing plain tool names with `+name` or `-name` in `--tools` fails with validation error (Pi coding agent 1.1.0 and later)

```bash
pi --tools read,+codemode -p "test"
```

```text
Error: --tools: tool names cannot be mixed with +name or -name entries
```

Fix: Use either an explicit allowlist of plain names (`pi --tools read,bash,codemode`) or modifiers alone to adjust the defaults (`pi --tools +codemode` or `pi --tools -bash`). ([source](https://github.com/earendil-works/pi/releases/tag/v1.1.0))

Fix page: https://insidetheloop.dev/fixes/pi-tools-cannot-mix-modifiers

### Passing wildcard `*` patterns to `+name` or `-name` modifiers in `--tools` is rejected (Pi coding agent 1.1.0 and later)

```bash
pi --tools "+mcp*" -p "test"
```

```text
Error: --tools: +name and -name entries take exact tool names, not patterns: +mcp*
```

Fix: Use exact tool names with `+` or `-` prefixes (e.g. `pi --tools +codemode`). If wildcard matching is needed to select specific MCP server tools, pass plain patterns without the modifier prefix: `pi --tools 'read,bash,mcp__radius__*'`. MCP tools remain enabled unless an entry starts with `mcp__`. ([source](https://github.com/earendil-works/pi/releases/tag/v1.1.0))

### Passing legacy `--provider azure-openai-responses` fails with unknown provider error (Pi coding agent 1.0.3 and later)

```bash
pi --provider azure-openai-responses --model gpt-4o -p "test"
```

```text
Error: Unknown provider "azure-openai-responses". Use --list-models to see available providers/models.
```

Fix: Replace `azure-openai-responses` with `azure`: `pi --provider azure --model gpt-4o`. Update provider keys in `auth.json`, `models.json`, and `.pi/settings.json`. ([source](https://github.com/earendil-works/pi/pull/9714))

Fix page: https://insidetheloop.dev/fixes/pi-unknown-provider-azure-openai-responses

### Passing `--no-mcp` on versions older than 1.0.4 fails with unknown option (Pi coding agent 1.0.3 and earlier)

```bash
pi --no-mcp -p "test"
```

```text
Error: Unknown option: --no-mcp
```

Fix: Upgrade to `@earendil-works/pi-coding-agent` 1.0.4 or later where `--no-mcp` is supported. On older versions, exclude individual MCP tools using `--exclude-tools 'mcp__*'` or disable servers in `.pi/mcp.json`. ([source](https://github.com/earendil-works/pi/releases/tag/v1.0.4))

### Running headless `pi -p` without credentials fails with missing API key (Pi coding agent 1.1.0 (observed))

```bash
pi -p "test"
```

```text
No API key found for the selected model.

Use /login to log into a provider via OAuth or API key. See:
  /usr/local/lib/node_modules/@earendil-works/pi-coding-agent/docs/providers.md
  /usr/local/lib/node_modules/@earendil-works/pi-coding-agent/docs/models.md
```

Fix: Set the provider's environment variable (e.g. `export ANTHROPIC_API_KEY="..."` or `export OPENAI_API_KEY="..."`), or run `pi /login` in an interactive terminal to store credentials. ([source](https://github.com/earendil-works/pi/blob/v1.1.0/packages/coding-agent/docs/quickstart.md))

### Running `pi auth check` without provider or model flags exits with code 2 (Pi coding agent 1.0.0 and later)

```bash
pi auth check
```

```text
Error: Auth checks require --provider <provider> or --model <model>
```

Fix: Specify `--provider <name>` or `--model <pattern>`: `pi auth check --provider anthropic` or `pi auth check --model claude-sonnet`. ([source](https://github.com/earendil-works/pi/releases/tag/v1.1.0))

## Pi coding agent release history by month

### 2026-10: 1.0.0 to 1.1.0 (6 releases)

- 1.1.0 (2026-10-07) added `--tools` `+name`/`-name` modifiers, OSC 7501 status reporting, GPT-6 Luna classifier, and Claude Haiku 5.5. ([source](https://github.com/earendil-works/pi/releases/tag/v1.1.0))
- 1.0.4 added `--no-mcp` and wildcard pattern matching for `--tools` and `--exclude-tools`. ([source](https://github.com/earendil-works/pi/releases/tag/v1.0.4))
- 1.0.3 renamed the Azure provider to `azure` and added Azure Foundry Chat Completions. ([source](https://github.com/earendil-works/pi/pull/9714))
- 1.0.0 launched stable 1.0 with fullscreen TUI by default and hardened MCP OAuth. ([source](https://github.com/earendil-works/pi/releases/tag/v1.0.0))

### 2026-09: 0.85.0 to 0.99.2 (9 releases)

- 0.99.0 added codemode with MCP tool orchestration, system terminal colors theme, and Sign in with ChatGPT. ([source](https://github.com/earendil-works/pi/releases/tag/v0.99.0))
- 0.87.0 added canonical session context (`ContextEditEntry`), extension boundary events, and per-model image input limits. ([source](https://github.com/earendil-works/pi/releases/tag/v0.87.0))

### 2026-08: 0.84.0 to 0.84.4 (5 releases)

- 0.84.0 introduced fullscreen TUI mode with sticky editor, Mermaid diagram and LaTeX rendering, and per-directory `AGENTS.override.md`. ([source](https://github.com/earendil-works/pi/releases/tag/v0.84.0))

### 2026-07: 0.80.5 to 0.83.0 (11 releases)

- 0.83.0 added external client credential export (`pi auth print-api-key`, `pi auth print-bearer-token`) and Claude Opus 5 on GitHub Copilot. ([source](https://github.com/earendil-works/pi/releases/tag/v0.83.0))

### 2026-06: 0.78.1 to 0.80.3 (16 releases)

- 0.80.3 added Anthropic Claude Sonnet 5 support, configurable `outputPad` spacing, and RPC session tree inspection (`get_entries`, `get_tree`). ([source](https://github.com/earendil-works/pi/releases/tag/v0.80.3))

### 2026-05: 0.71.1 to 0.78.0 (17 releases)

- 0.78.0 added named startup sessions (`--name` / `-n`) and OSC 8 clickable `file://` hyperlinks for file tools. ([source](https://github.com/earendil-works/pi/releases/tag/v0.78.0))

## Sources

- [earendil-works/pi releases (GitHub API)](https://api.github.com/repos/earendil-works/pi/releases) (read 2026-10-10)
- [@earendil-works/pi-coding-agent on the npm registry](https://registry.npmjs.org/@earendil-works/pi-coding-agent) (read 2026-10-10)
- [Pi coding agent 1.1.0 release notes](https://github.com/earendil-works/pi/releases/tag/v1.1.0) (read 2026-10-10)
- [Pi coding agent 1.0.4 release notes](https://github.com/earendil-works/pi/releases/tag/v1.0.4) (read 2026-10-10)
- [Pi coding agent 1.0.3 release notes](https://github.com/earendil-works/pi/releases/tag/v1.0.3) (read 2026-10-10)
- [Pi coding agent 1.0.2 release notes](https://github.com/earendil-works/pi/releases/tag/v1.0.2) (read 2026-10-10)
- [Pi coding agent 1.0.1 release notes](https://github.com/earendil-works/pi/releases/tag/v1.0.1) (read 2026-10-10)
- [Pi coding agent 1.0.0 release notes](https://github.com/earendil-works/pi/releases/tag/v1.0.0) (read 2026-10-10)
- [PR #9714: rename azure-openai-responses provider to azure](https://github.com/earendil-works/pi/pull/9714) (read 2026-10-10)
- [PR #9776: add samplingParamsByThinkingLevel to models.json](https://github.com/earendil-works/pi/pull/9776) (read 2026-10-10)
- [PR #9137: add official Nix flake for pi](https://github.com/earendil-works/pi/pull/9137) (read 2026-10-10)
- [PR #10316: add Cloudflare Clef classifier models](https://github.com/earendil-works/pi/pull/10316) (read 2026-10-10)
- [PR #10382: add llama.cpp decision models as classifiers](https://github.com/earendil-works/pi/pull/10382) (read 2026-10-10)
- [Issue #10607: OSC 7501 program status reporting and aborted event](https://github.com/earendil-works/pi/issues/10607) (read 2026-10-10)
- [Issue #10565: MCP login timeout for full authorization flow](https://github.com/earendil-works/pi/issues/10565) (read 2026-10-10)
- [Issue #10473: prevent standalone binaries loading local .env files into process env](https://github.com/earendil-works/pi/issues/10473) (read 2026-10-10)
- [Issue #10444: freeze JS built-in prototypes before running codemode scripts](https://github.com/earendil-works/pi/issues/10444) (read 2026-10-10)
- [Issue #10493: register native client redirect URIs for MCP OAuth servers](https://github.com/earendil-works/pi/issues/10493) (read 2026-10-10)
- [Issue #10310: save codemode generated images to temporary files](https://github.com/earendil-works/pi/issues/10310) (read 2026-10-10)
- [Issue #10314: move editor line start/end navigation to Home/End](https://github.com/earendil-works/pi/issues/10314) (read 2026-10-10)
- [Issue #10302: MCP Client ID Metadata Documents support](https://github.com/earendil-works/pi/issues/10302) (read 2026-10-10)
- [Issue #10285: add pi.registerToolRenderer for unregistered tools](https://github.com/earendil-works/pi/issues/10285) (read 2026-10-10)
- [Issue #10277: support project overrides for user-level MCP servers](https://github.com/earendil-works/pi/issues/10277) (read 2026-10-10)
- [Issue #5653: remove npm-shrinkwrap.json from published package](https://github.com/earendil-works/pi/issues/5653) (read 2026-10-10)
- [Issue #10143: syntax highlighting multiline string color fix](https://github.com/earendil-works/pi/issues/10143) (read 2026-10-10)
- [Pi coding agent quickstart documentation at v1.1.0](https://github.com/earendil-works/pi/blob/v1.1.0/packages/coding-agent/docs/quickstart.md) (read 2026-10-10)
- [Pi coding agent models documentation at v1.0.2](https://github.com/earendil-works/pi/blob/v1.0.2/packages/coding-agent/docs/models.md#configure-sampling-by-thinking-level) (read 2026-10-10)
- [Pi agent core changelog at v1.0.0](https://github.com/earendil-works/pi/blob/v1.0.0/packages/agent/CHANGELOG.md) (read 2026-10-10)
- [Pi coding agent settings documentation at v1.1.0](https://github.com/earendil-works/pi/blob/v1.1.0/packages/coding-agent/docs/settings.md) (read 2026-10-10)
- [earendil-works/pi repository (stars, MIT licence)](https://github.com/earendil-works/pi) (read 2026-10-10)
- [Official Pi website](https://pi.dev) (read 2026-10-10)

_Last verified: 2026-10-10._