@easii/pi

Stack detector for Pi: suggests skills, MCPs and SDD schemas for your project.

Pi package from Easii Studio that automatically detects your project tech stack and suggests relevant skills, MCPs and SDD flows.

Standalone or with gentle-pi?

Works standalone with vanilla Pi. No dependencies required.

Gentle-pi adds SDD/OpenSpec workflows on top. @easii/pi integrates with it by:

• Pre-populating openspec/config.yaml with detected stack hints when /sdd-init runs
• Suggesting the rn-feature schema for React Native projects
• Providing capability audit that gentle-pi can forward to its skill registry

If you use gentle-pi:

pi install npm:@easii/pi npm:gentle-pi

If you use vanilla Pi:

pi install npm:@easii/pi

Installation

pi install npm:@easii/pi

Recommended companions (optional)

pi install npm:gentle-engram                # persistent memory across sessions
pi install npm:@juicesharp/rpiv-ask-user-question  # structured dialogs

What it includes

Stack Detector

On session_start, the package reads your package.json and detects the project profile. By default, it shows a one-liner only on the first session or when the stack changes. Use /easii:stack for the full report.

Profile	Trigger
react-native-expo	expo dependency
react-native-bare	react-native without expo
nextjs	next dependency
react-web	react without RN
node-backend	main field, no react
npm-library	types or files field
gamedev-phaser	phaser dependency
gamedev-pixi	pixi.js dependency
unknown	none of the above

Manual re-run:

/easii:stack

Built-in skills

Skill	When
expo	Expo SDK, EAS Build, Expo Router, managed/bare
react-native	Testing, components, performance, iOS/Android differences
rn-e2e-maestro	E2E flows; only suggested if @maestro/cli or .maestro/ exists

/skill:expo
/skill:react-native
/skill:rn-e2e-maestro

Suggested MCPs

/easii:stack suggests MCPs based on your deps and avoids duplicates in .mcp.json / .pi/mcp.json.

Trigger	MCP
Expo	Expo MCP
@supabase/*	Supabase MCP
Playwright	Playwright MCP
Prisma / Postgres deps	PostgreSQL MCP
Firebase	Firebase MCP
Stripe	Stripe MCP
Next / React / Node	Context7 MCP

Schema rn-feature and SDD setup

SDD flow tailored for React Native features:

proposal → specs → design → tasks → apply

Includes:

• Platform considerations (iOS/Android)
• Testing strategy (unit + optional E2E)
• PR checklist

For React Native / Expo projects:

/easii:setup-project

This command:

1. Shows interactive summary, asks confirmation
2. If confirmed, asks about missing capabilities (strict TDD, E2E, CI/CD, Docker)
3. Copies assets/schemas/rn-feature/ → openspec/schemas/rn-feature/
4. Sets schema: rn-feature in openspec/config.yaml
5. Adds managed block with detected stack and setup preferences for /sdd-init
6. Infers test_command, E2E, typecheck, lint and format when scripts exist

Commands

Command	What
/easii:stack	Detect stack, audit capabilities, suggest skills/MCPs
/easii:setup-project	Configure OpenSpec for RN/Expo with rn-feature schema and hints for /sdd-init

Usage examples

/easii:stack output

[@easii/pi] Stack detected: React Native + Expo
  ✓ TypeScript
  ✓ Expo Router
  ✓ EAS Build
  ✓ Tests: vitest

Detected capabilities — read-only
  ✓ Unit tests: configured → vitest
  ✓ E2E: configured → maestro test
  ~ Strict TDD: detected without clear checks
  ✓ CI: configured with quality checks
  ~ CD/deploy: platform file detected

Suggested skills — already applicable to this stack
  → [marketplace] @expo/expo-hog   ★4.8  (12,400 installs)
     Install: npx skills add expo/expo-hog
     Expo-specific linting, type checking, and best practices

  → [@easii/pi] /skill:expo  — Expo SDK, EAS Build, Expo Router, managed/bare
  → [@easii/pi] /skill:react-native  — Testing, components, performance, iOS/Android differences

Suggested MCPs — entries for mcpServers in .mcp.json or .pi/mcp.json
  → Expo MCP  — SDK docs, simulator and local Expo flows
     { "command": "npx", "args": ["-y", "expo-mcp@latest"], "lifecycle": "lazy" }
     Tip: with pi-mcp-adapter, use /mcp setup to import existing configs.

/easii:setup-project interaction

/easii:setup-project

[@easii/pi] OpenSpec setup for React Native + Expo

Current state:
  schema: not configured
  test_command: "vitest"
  e2e: maestro detected (maestro test)
  typecheck: "npx tsc --noEmit"
  strict_tdd: not configured (available to enable)
  ci: github workflows detected

Recommendations for your profile:
  • strict_tdd: enable (vitest detected, not configured in openspec/config.yaml)
  • e2e: keep maestro (already detected)
  • ci: keep github workflows (already configured)
  • cd: pending (no deploy workflow detected)

Configure OpenSpec? [y/N]:

Skills auto-suggested by stack

When your project has Expo:

Suggested skills — already applicable to this stack
  → [@easii/pi] /skill:expo  — Expo SDK, EAS Build, Expo Router, managed/bare
  → [@easii/pi] /skill:react-native  — Testing, components, performance, iOS/Android differences

When Maestro is detected:

  → [@easii/pi] /skill:rn-e2e-maestro  — E2E flows with Maestro detected in the project

Capabilities read-only audit

Detected capabilities — read-only
  ✓ Unit tests: configured → vitest run
     (vitest detected via script)

  ✓ E2E: configured → maestro test
     (maestro detected via script)

  ~ Strict TDD: detected without clear checks

  ✓ CI: configured with quality checks

  ~ CD/deploy: platform file detected

  – Docker: not evaluated for this profile
     (not applicable for react-native-expo)

Verbosity

By default, @easii/pi runs silently on session_start and shows a one-liner only when the stack changes. Full output is on-demand via /easii:stack.

Configure verbosity in .pi/settings.json:

{
  "easii": {
    "verbosity": "minimal"
  }
}

Value	Behavior
minimal (default)	One-liner on first session or when stack changes
full	Full dump on every session (includes marketplace fetch, ~4s latency)
off	Completely silent on session_start

Note: full mode is the legacy behavior. It makes a network call to the skills marketplace on every session.

Backward compatibility

To restore the old behavior (full dump on every session):

{
  "easii": {
    "verbosity": "full"
  }
}

Development

# Install locally for testing
pi install .

# Test extension without installing
pi -e ./extensions/stack-detector.ts

# TypeScript check
npx tsc --noEmit

# Preview what would be published to npm
npm pack --dry-run

Contributing

Issues and PRs welcome at github.com/easii-studio/pi.

License

MIT — Easii Studio