---
slug: "lajarre-pi-session-ask"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/lajarre/pi-session-ask@main/README.md"
repo: "https://github.com/lajarre/pi-session-ask"
source_file: "README.md"
branch: "main"
---
# pi-session-ask

Ask questions about any Pi session — by **file path** or **session UUID** — via an isolated subagent that keeps your current context clean.

Fork of [w-winter/dot314 `session-ask`](https://github.com/w-winter/dot314/tree/main/packages/pi-session-ask), with UUID resolution added.

## Install

```bash
pi install npm:@lajarre/pi-session-ask
# or from git:
pi install git:github.com/lajarre/pi-session-ask
```

## Usage

### Slash command

```text
/session-ask <question>                                # current session
/session-ask <question> --path /path/to/session.jsonl  # by file path
/session-ask <question> --id a1b2c3d4                  # by session UUID (full or prefix)
```

### LLM tools

```ts
session_ask({ question: "What went wrong?" })                                  // current session
session_ask({ question: "...", sessionPath: "/path/to/session.jsonl" })        // by path
session_ask({ question: "...", sessionPath: "a1b2c3d4" })                      // UUID prefix — auto-resolved
session_ask({ question: "...", sessionPath: "a1b2c3d4-e5f6-7890-abcd-..." })  // full UUID — auto-resolved
```

### Session lineage

```ts
session_lineage({ maxDepth: 50 })
session_lineage({ sessionPath: "a1b2c3d4" })  // also accepts UUID
```

## How it works

See [extensions/session-ask/README.md](https://github.com/lajarre/pi-session-ask/blob/HEAD/extensions/session-ask/README.md) for the full architecture.

## Configuration

See [extensions/session-ask/config.json.example](https://github.com/lajarre/pi-session-ask/blob/HEAD/extensions/session-ask/config.json.example).

## Upstream

Original extension by [Warren Winter](https://github.com/w-winter) — [dot314](https://github.com/w-winter/dot314).

## License

MIT — see [LICENSE](https://github.com/lajarre/pi-session-ask/tree/HEAD/LICENSE).