# Project Extensions

This directory contains project-local pi extensions.

## Purpose
These extensions provide capabilities specific to this repository and the user's workflow.

Current priorities:
- remote administration
- infrastructure automation
- sysadmin/devops assistance
- durable workflow support

## Conventions
- Prefer one extension per file or per subdirectory with `index.ts`
- Keep extensions focused by responsibility
- Put reusable helpers in subdirectories when the extension set grows
- Prefer project-local extensions here for repo-specific behavior
- Reserve global `~/.pi/agent/extensions/` for truly cross-project behavior

## Initial extension set
- `ssh.ts` — routes built-in file and shell tools over SSH when `--ssh` is enabled
- `questionnaire.ts` — interactive multi-question clarification UI/tool for selectable answers, custom responses, option extensions, review, and submit

Related config:
- `.pi/ssh/hosts.json` — active SSH host aliases and policy
- `.pi/ssh/hosts.example.json` — example inventory

## Loading
Pi auto-discovers extensions from `.pi/extensions/`.
Use `/reload` after editing extensions.

## Suggested future extensions
- SSH policy / host allowlist
- destructive action confirmation
- Proxmox API integration
- inventory / host registry
- task/calendar bridge helpers
- session/runbook helpers