pi-workspace-context

Pi extension that lets you add extra local directories as part of the current workspace context.

Useful when a task spans multiple repositories, for example a frontend repo plus a backend repo.

Install

pi install npm:pi-workspace-context

Try without installing permanently:

pi -e npm:pi-workspace-context

Local development

pi -e .

Commands

• /ctx-add <path> [alias] — add an extra directory to the current session context.
• /ctx-list — list extra directories currently in context.
• /ctx-remove <alias|path> — remove one extra directory.
• /ctx-clear — remove all extra directories.
• /ctx-persist [on|off|status] — persist the extra directories for future pi sessions started in the same workspace.

Alias usage

After adding a directory, pi will show an alias such as @backend.

The extension expands aliases in tool calls:

• @backend/src/file.ts
• $backend/src/file.ts
• backend:src/file.ts

For bash commands, simple @alias/path and $alias/path tokens are expanded to the absolute path.

Context behavior

The extension injects the added roots into pi's system prompt and asks the model to treat them as part of the workspace.

If an added root contains AGENTS.md or CLAUDE.md, the model is instructed to read it before editing that root.

Skill directories under added roots are discovered on reload from:

• .pi/skills
• .agents/skills

Security

This extension runs locally inside pi and can influence tool paths/commands by expanding aliases. Review the source before installing, as with any pi package.