@ayhanblt/ay-pi2.0.4

AY-PI is an extension for the Pi coding agent. Before every prompt it decides what kind of work you are asking for, and then:

• 🧭 picks the tier: a quick question gets a cheap model, a plan gets your strongest one;
• 🔒 scopes the tools: only coding turns can edit files or run commands (extension and MCP tools too, unless they declare themselves read-only);
• 🤖 picks the model in auto mode, or just suggests one in manual mode.

your prompt  ──▶  behavior (CHAT, SUGGEST, REVIEW, PLAN, CODE)  ──▶  tier (low, medium, high)  ──▶  model

It works with every provider Pi supports. You choose the models, AY-PI chooses the tier.

Install

pi install npm:@ayhanblt/ay-pi

Requires Pi 1.4 or newer.

Set up in 3 steps

1. Log in to the providers you use:

/login

2. Put a model into each tier. Each command opens a model picker:

/ay-pi add low       → a fast, cheap model
/ay-pi add medium    → your everyday model
/ay-pi add high      → your strongest model

Check the result with /ay-pi:

Mode: manual (openai-codex/gpt-6.1-sol)
Tier: auto
  low    openai-codex/gpt-6-luna
  medium openai-codex/gpt-6.1-sol
  high   openai-codex/gpt-6-astra
Classifier: none (auto)
Pending plan: no

You can add more than one model to a tier. They form a fallback chain: the first usable one answers.

3. Turn on auto mode:

/ay-pi auto

The footer now shows AY-PI ready · auto tier · auto. You are ready.

💡 Optional but recommended: add Jev so you can skip the commands and just type.

Your first session, step by step

The examples below use the tiers from step 2. Watch the footer after each prompt.

Ask a question. A cheap model answers, files stay untouched.

/chat what does math.js do?

AY-PI CHAT · low · auto · gpt-6-luna

Get a review. Findings only, no edits.

/review math.js

AY-PI REVIEW · medium · auto · gpt-6.1-sol

Plan the change. Your strongest model writes a plan under a ## Plan heading. AY-PI keeps it.

/plan fix add() in math.js and add a test

AY-PI PLAN · high · auto · gpt-6-astra

Talk about the plan. Still read-only; AY-PI reminds you that a plan is waiting.

what are the risks of this plan?

AY-PI CHAT · medium · auto · gpt-6.1-sol

Implement it. Type /code and press Enter (pick code if autocomplete shows a list). The plan is handed to the coding model, and the file tools are switched back on.

/code

AY-PI CODE · medium · auto · gpt-6.1-sol

/code with text adds a note: /code also update the README. If the model answers /plan with a question instead of a plan, your earlier plan stays pending.

Let Jev decide

Without a classifier, AY-PI only knows what your commands tell it. A prompt without a command gets the safe default: CHAT, medium tier, read-only.

With Jev, a small and fast classification model, you can just type. A decision costs a fraction of a cent and adds little latency.

1. Add your key: run /login, choose TypeSafe and paste your API key (or set TYPESAFE_API_KEY).

2. Check it: /ay-pi jev shows the classifier AY-PI uses. /ay-pi shows it on the Classifier: line.

3. Just type:

Commands still win: /plan, /code and the others skip the classifier.

Reading the footer

AY-PI CODE · low→medium · auto · gpt-6.1-sol
      │      │            │      └─ the model that answered (auto mode only)
      │      │            └─ auto or manual mode
      │      └─ the decided tier; "low→medium" means low was empty or unusable
      └─ the behavior for this prompt

Before the first prompt it reads AY-PI ready · auto tier · auto. /ay-pi shows the same, plus the reason for the last decision.

Modes and tiers

Auto mode (/ay-pi auto): the selected model is ay-pi/auto. For each prompt it picks the first usable model of the decided tier. Tool follow-ups stay on the same model, so the prompt cache stays warm.

Manual mode (/ay-pi manual): you pick the model with /model. AY-PI still scopes the tools and adds the instructions, and tells you when it would pick another tier:

AY-PI suggests the high tier (openai-codex/gpt-6-astra) for this PLAN request.

Pin a tier for the session with /ay-pi tier high (or low, medium). Every prompt then uses that tier. /ay-pi tier auto gives the choice back.

Fallback: if a tier is empty or its models are unusable, the neighbouring tier answers (a missing high falls back to medium before low). A failed request is retried on the next model of the chain.

Reference

Behaviors

"Cannot change files" means edit, write and bash are switched off for that turn.

Commands

{
  "tiers": {
    "low": ["anthropic/claude-haiku-4-5"],
    "medium": ["anthropic/claude-sonnet-4-5", "openai-codex/gpt-5.6-terra"],
    "high": ["openai-codex/gpt-5.6-sol"]
  },
  "classifier": "auto"
}

Troubleshooting

Development

npm install
npm run typecheck
npm test
npm run build        # bundles src/ into extension/ay-pi/dist

The published package lives in extension/ay-pi. See docs/architecture.md for the code layout.

License

MIT