---
slug: "nmzpy-pi-ember-stack"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/nmzpy/pi-ember-stack@master/README.md"
repo: "https://github.com/nmzpy/pi-ember-stack"
source_file: "README.md"
branch: "master"
---
# pi-ember-stack

The Ember-owned pi package. It installs the complete Ember agent workflow as
one package:

- Primary modes: `/coder`, `/architect`, `/doctor`, `/orchestrator`, and
  `/ui-doctor`.
- Inline `quiz` UI for decision-oriented questions. Agents are told to
  prefer it when they need a user choice.
- A compact native `edit` renderer that shows the filename and a single
  `+N / -N` result row.
- Vendored subagent support with bundled `coder` and `architect` definitions,
  plus the upstream bundled roles.
- Bundled Devin auth/provider support, including OAuth, model catalog refresh,
  and streaming transport.
- Cursor subscription support through the official Cursor Agent CLI, with Pi
  retaining its native session and tool loop.
- Dynamic context pruning (`pi-ember-dcp`): outbound-only dedup/error purge,
  optional LLM `compress` tool, and `/dcp` controls. Session history on disk is
  not rewritten; only the messages sent to the model are pruned.
- A self-contained `Ctrl+Space` mode-cycle shortcut and a footer showing the
  active mode, model, and thinking variant.

## Plugin registry

The package has one top-level pi extension which dispatches to the internal
plugins under `plugins/`. Enable them globally in `PI_HOME/pi-ember-stack.json`:

```json
{
  "plugins": [
    "pi-compact-tools",
    "devin-auth",
    "pi-cursor-auth",
    "pi-custom-agents",
    "pi-ember-dcp",
    "pi-ember-fff",
    "pi-ember-ui",
    "pi-ember-tps",
    "pi-ember-webtools"
  ]
}
```

Remove a plugin ID to disable it, or use `/stack-plugins` to toggle one from
the TUI. Restart pi after changing the list. The available plugins are:

- `pi-compact-tools`: collapsed native edit rendering.
- `pi-custom-agents`: quiz UI, primary modes, plans, subagent tool, and bundled agent definitions.
- `devin-auth`: Devin provider, OAuth, catalog refresh, and streaming.
- `pi-cursor-auth`: Cursor subscription auth, model refresh, and native Pi streaming.
- `pi-ember-dcp`: dynamic context pruning, `compress` tool, `/dcp` commands, and bundled `pi-dcp` skill.
- `pi-ember-fff`: FFF-powered grep/find with compact rendering.
- `pi-ember-ui`: Ember accent theme and TUI chrome.
- `pi-ember-tps`: tokens-per-second meter.
- `pi-ember-webtools`: web search, URL fetching, and related extraction tools.

`pi-ember-dcp` is on by default with the other stack plugins. Toggle it via
`/stack-plugins` or by editing the global `plugins` list. DCP user config and
session state live under `~/.pi-dcp/` (optional project override:
`<cwd>/.pi/dcp.json`).

## Project setup

The Ember repository contains a project-local `.pi/settings.json` entry for:

```json
"npm:@nmzpy/pi-ember-stack@0.1.6"
```

On a new clone, start pi from the project directory. Pi will ask for a
one-time project trust decision before it installs the package into the
project-local `.pi/npm/` directory. The same decision can be approved
non-interactively with:

```text
pi --approve
```

Project trust is intentionally a user decision; a repository cannot safely
bypass it. After trust, normal startup is just `pi` from the Ember directory.

When a new version is intentionally released, update the pinned version in
the project settings and run:

```text
pi update --extensions
```

Third-party utilities such as pi-fff and image paste remain separate package
entries. Devin auth is now bundled as a stack plugin, but credentials and
provider secrets stay in the machine-local pi configuration and are not part
of this repository. DCP state under `~/.pi-dcp/` is also machine-local.

## Development

The package entrypoint is `plugins/index.ts`. Compact tools are under
`plugins/pi-compact-tools/`, while quiz, primary modes, plans,
subagents, and bundled agents are under `plugins/pi-custom-agents/`. Provider
plugins are under `plugins/devin-auth/` and `plugins/pi-cursor-auth/`. Dynamic context pruning is under `plugins/pi-ember-dcp/`.

Run the package typecheck with:

```text
npm install
npm run typecheck
```

## Release

Run `./gacp.sh --release` to bump the patch version, typecheck, commit, tag,
push, and publish the package to npm. This only publishes the package; update
Ember's pinned package version separately when you want the project to install it.

The package is cross-platform: bundled paths are resolved from `import.meta.url`
and do not depend on a Windows home directory or the current working
directory.