pi-extensions

Pi extension development master reference. Use when: building pi extensions, debugging extension behavior, or choosing the right pattern.

Ir para a instalação

Repositório: Dwsy/pi-extensions-skill
Última atividade na origem: 27 de junho de 2026 às 14:56
Idioma detectado do SKILL.md: inglês
Estrelas: 16
Forks: 1

Opções de instalação

Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.

npx skills add https://github.com/Dwsy/pi-extensions-skill --skill pi-extensions

O comando permanece em uma só linha. Role horizontalmente para revisá-lo antes de copiar.

Prefere uma cópia local? Baixe os arquivos disponíveis atualmente no SkillsMP.

Revise os arquivos de origem

Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.

SKILL.md

Instruções da origem · Visualização somente leitura

Voltar à pesquisa Voltar à instalação

guides/02-paradigms.md

I need to understand how extensions work
  └─► ARCHITECTURE.md

I need working code to copy
  └─► PATTERNS.md

I need to know what NOT to do
  └─► ANTI-PATTERNS.md

I need a step-by-step first tutorial
  └─► guides/01-quickstart.md

I need deep narrative on tools/events/UI
  └─► guides/02-paradigms.md

I need state persistence strategies
  └─► guides/03-state.md

I need production architecture (workflows, memory)
  └─► guides/04-production.md

I need RPC mode specifics
  └─► guides/05-rpc-mode.md

I need pi internals (loader, runner, binding)
  └─► guides/06-internals.md

I need startup optimization, speed up extension loading
  └─► references/startup-optimization.md

I need provider plugins, OAuth, overrides
  └─► guides/07-advanced-patterns.md

Need LLM to perform action? ───────────────► Tool (PATTERNS P2–P5)
Need user to type /command? ───────────────► Command (PATTERNS P6–P7)
Need keyboard shortcut? ───────────────────► Shortcut (guides/02-paradigms.md)
Need to react to system events? ───────────► Event handler (PATTERNS P8–P11)
Need interactive TUI? ─────────────────────► Custom UI (PATTERNS P12–P14)
Need to inject a model provider? ──────────► registerProvider (PATTERNS P19–P20)
Need to override a built-in tool? ─────────► Tool override (PATTERNS P4)

State should go to LLM context? ───────────► sendMessage({ customType, ... })
State is extension-private? ───────────────► appendEntry("customType", data)
State is user preference (cross-project)? ─► File in ~/.pi/agent/
State is project-local? ───────────────────► File in .pi/
State is temporary cache? ─────────────────► Local variable (reconstructed on reload)

File	Level	Topic
`guides/01-quickstart.md`	🌱 Beginner	First extension in 5 minutes
`guides/02-paradigms.md`	🌿 Intermediate	Tools, commands, events, UI deep dive
`guides/03-state.md`	🌳 Advanced	Persistent and branch-resilient state
`guides/04-production.md`	🏔️ Expert	Multi-mode, workflows, memory systems
`guides/05-rpc-mode.md`	🔌 RPC	RPC mode compatibility and degradation
`guides/06-internals.md`	⚙️ Internals	Loader, runner, event dispatch, binding
`guides/07-advanced-patterns.md`	🚀 Advanced	Provider plugins, OAuth, tool overrides, file mutation queues

File	Purpose
`references/api.md`	Complete API documentation
`references/api-quickref.md`	Quick reference card
`references/events.md`	Full event reference
`references/examples.md`	Additional code examples
`references/ui-components.md`	TUI component catalog
`references/extension-patterns-from-source.md`	Multi-agent, diff rendering, config patterns from 10+ extensions
`references/tui-beautiful-rendering.md`	Beautiful TUI: box drawing, transcript, overlays, badges, SVG/HTML widgets
`references/startup-optimization.md`	Startup perf: jiti transpilation, .js vs .ts, measuring bottlenecks

# 1. Create the sample extension file
mkdir -p ~/.pi/agent/extensions
cat > ~/.pi/agent/extensions/hello.ts << 'EOF'
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";

export default function (pi: ExtensionAPI) {
  pi.registerCommand("hello", {
    description: "Say hello",
    handler: async (_args, ctx) => {
      ctx.ui.notify("Hello from Pi Extensions!", "success");
    },
  });
}
EOF

# 2. Test with -e flag (temporary load)
pi -e ~/.pi/agent/extensions/hello.ts
# Then type: /hello
#
# Tip: Extensions in ~/.pi/agent/extensions/ are auto-discovered.
#      The -e flag is only needed for temporary testing.

// Core types
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";

// Schema
import { Type } from "@sinclair/typebox";
import { StringEnum } from "@earendil-works/pi-ai";

// TUI
import { Container, Text, SelectList } from "@earendil-works/pi-tui";

// Utilities
import { withFileMutationQueue } from "@earendil-works/pi-coding-agent";
import { isToolCallEventType, isBashToolResult } from "@earendil-works/pi-coding-agent";

Priority	Document	Read When
1	`ARCHITECTURE.md`	Before writing ANY extension code
2	`PATTERNS.md`	When you need copy-paste code for a specific task
3	`ANTI-PATTERNS.md`	When reviewing or debugging extension code

Priority	Document	Read When
1	`ARCHITECTURE.md`	Before writing ANY extension code
2	`PATTERNS.md`	When you need copy-paste code for a specific task
3	`ANTI-PATTERNS.md`	When reviewing or debugging extension code

File	Purpose	Length
`ARCHITECTURE.md`	Mental model, execution flow, exact event semantics	~9KB
`PATTERNS.md`	38 copy-paste patterns with exact imports	~17KB
`ANTI-PATTERNS.md`	15 common mistakes with corrections	~9KB

pi-extensions

Opções de instalação

Revise os arquivos de origem

Pi Extensions — LLM Master Reference

Start Here (Read Order)

One-Line Directives

Pi Extensions — LLM Master Reference

Start Here (Read Order)

One-Line Directives

Master Decision Trees

Which document do I need?

Which paradigm should I use?

Which state persistence mechanism?

Document Map

Master References (Read First)

Progressive Guides (Read as Needed)

Reference Docs

Tutorials

Examples

5-Minute Quick Test

Quick Import Cheat Sheet

Hot Topics

Dynamic Model Injection

Tool Override

Parallel Execution Safety

RPC Safety

name	pi-extensions
description	Pi extension development master reference. Use when: building pi extensions, debugging extension behavior, or choosing the right pattern.

pi-extensions

Informações da origem

Opções de instalação

Revise os arquivos de origem

Pi Extensions — LLM Master Reference

Start Here (Read Order)

One-Line Directives

Pi Extensions — LLM Master Reference

Start Here (Read Order)

One-Line Directives

Master Decision Trees

Which document do I need?

Which paradigm should I use?

Which state persistence mechanism?

Document Map

Master References (Read First)

Progressive Guides (Read as Needed)

Reference Docs

Tutorials

Examples

5-Minute Quick Test

Quick Import Cheat Sheet

Hot Topics

Dynamic Model Injection

Tool Override

Parallel Execution Safety

RPC Safety