Jihye · 지혜 · 智慧

Jihye is an installable toolkit for shaping Pi around your workflow. It bundles focused extensions, reusable skills, portable agent definitions, and global/workspace guidance into one package that works consistently across workstations.

Components

• Extensions — tools, commands, lifecycle integrations, terminal features, and their configuration.
• Skills — reusable workflows that Pi loads on demand.
• Personas — global and workspace guidance, local-configuration templates, and portable subagent definitions.

Requirements

• Pi coding agent 0.83.0 or newer.
• Node.js with TypeScript type stripping support for development and local-path installs.
• GitHub CLI 2.82.1 or newer when creating or editing pull requests; earlier versions fail gh pr edit on deprecated Projects Classic APIs.

Install

From GitHub

pi install git:git@github.com:thomasdhc/Jihye

If SSH is not configured on the machine, HTTPS works too:

pi install git:https://github.com/thomasdhc/Jihye.git

Pull future package updates with:

pi update --extensions

Run /reload in an existing Pi session after installing or updating.

From a local checkout

git clone git@github.com:thomasdhc/Jihye.git
cd Jihye
npm install
pi install .

A local-path installation loads changes directly from the checkout; run /reload after editing. Run npm install in the checkout before loading the package.

Configure Persona

Pi packages do not install context files automatically, so configure two symlinks after installing Jihye. The commands below expect both destinations not to exist; inspect and remove obsolete symlinks first, and never overwrite a regular context file.

JIHYE=/path/to/Jihye
WORKSPACE=/path/to/workspace

ln -s "$JIHYE/personas/JIHYE.md" ~/.pi/agent/AGENTS.md
ln -s "$JIHYE/personas/WORKSPACE.md" "$WORKSPACE/AGENTS.md"

The workspace root keeps machine-local REPO.md and USERNAME.md files. The jihye-setup extension resolves the package, personas, and workspace locations behind those symlinks, so guidance can reference sibling GIT.md policy without an agent deriving any path by hand.

Verify the chain with /jihye-setup: both guidance locations should report as managed and loaded, workspace_profile should read standard or strict, and the two local environment files should be listed. See the personas guide for strict-profile setup and local-configuration templates.

Utility Scripts

• Pi session metric plots regenerate content-free context-epoch structure, per-date message/decision-round, daily aggregate, and cache-adjusted token-distribution graphs from derived usage CSVs.

Development

Read the Jihye Development Doctrine before changing repository guidance, personas, skills, or their governing vocabulary.

Requires a Node.js version that supports type stripping.

npm install
npm test

Pi loads extensions from extensions/ and skills from skills/ through the package manifest. See the extension guide and skill guide for component-specific setup and usage.