@agimon-ai/doompi-git

Git worktree sessions for DoomPi: spawn an isolated worktree with its own session and manage it from the parent

This package is a composable DoomPi subsystem. Use it with the distribution or install it independently in Pi.

Requirements

• Node.js 22.19.0 or newer
• @earendil-works/pi-coding-agent 0.85.0

Install

pi install npm:@agimon-ai/doompi-git

The package declares its Pi extension entry, so Pi loads it after installation. DoomPi users can include the package through their normal profile and domain composition instead.

Use

Run the registered command in Pi:

/doom-git

Show git worktrees owned by this session

Package behavior

Before publishing, replace this paragraph with one concrete, copy-pasteable example of the package-specific input, output, configuration, or workflow that is not already demonstrated by the generated command.

Help

The published package includes llms.txt and the package-owned src/prompts/doompi-use-git/SKILL.md. When the DoomPi Help minor mode is active, the extension contributes doompi-use-git to its live Help catalog. The contribution follows Help provider replacement and is withdrawn when the extension shuts down.

Help remains optional. Loading the standalone Pi extension does not require DoomPi Help or any other DoomPi runtime service.

To add another package-owned Help prompt, use the scaffold-doom-prompt feature with a doompi-author-* or doompi-use-* name and a concise description. Then link the generated SKILL.md from llms.txt and register a matching descriptor through the optional DOOM_HELP_SERVICE injection in the Pi adapter. Keep prompts as published resources under src/prompts; do not export them or copy them into dist.

Public API

import { DefaultGitExtensionService, activateGitExtension } from '@agimon-ai/doompi-git';

The Pi host entry is also available at:

@agimon-ai/doompi-git/extensions/pi

The service layer is host-neutral. The Pi entrypoint owns only command registration and its runtime-scoped installation guard.

Development

pnpm build
pnpm typecheck
pnpm test
pnpm lint
pnpm exec vibe-lint check .
npm pack --dry-run

Maintained by Agimon.

License

MIT

Named Pi and server factories live in src/extensions. Controllers declare commands and APIs; services own worktree operations and filesystem persistence; tools return typed Pi declarations. Public services and types are exposed through flat src/exports. The server factory owns the worktree message inbox and closes it through onDispose.