---
slug: "nehlis-pi-effort"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/niels-bosman/pi-effort@main/README.md"
repo: "https://github.com/niels-bosman/pi-effort"
source_file: "README.md"
branch: "main"
---
# pi-effort

A tiny [Pi](https://pi.dev) package that adds `/effort`, a slash command for changing the active reasoning/thinking level without opening model settings.

## Install

```bash
pi install npm:@nehlis/pi-effort
```

Then restart Pi or run:

```txt
/reload
```

## Usage

```txt
/effort low
/effort medium
/effort high
/effort xhigh
```

With no argument, `/effort` opens an interactive selector in Pi's TUI.

### Levels

| Input | Result |
| --- | --- |
| `off`, `none`, `0` | `off` |
| `minimal`, `min`, `1` | `minimal` |
| `low`, `2` | `low` |
| `medium`, `med`, `3` | `medium` |
| `high`, `hi`, `4` | `high` |
| `xhigh`, `max`, `maximum`, `5` | `xhigh` |

Pi may clamp the requested level depending on the active model's capabilities. When that happens, `/effort` reports both the requested and effective levels.

## Local development

Clone the repo and run the extension locally:

```bash
pi -e .
```

Or install it from a local checkout:

```bash
pi install /path/to/pi-effort
```

Validate package contents before publishing:

```bash
npm run pack:dry
```

Type-check:

```bash
npm install
npm run check
```

## Publishing

This package is scoped, so publish it publicly with:

```bash
npm publish --access public
```

The package includes the `pi-package` keyword and a `pi.extensions` manifest so it can be discovered by Pi's package catalog.

## License

MIT