Pi Card

More controls. Better steering. Engage!

Smart steering for PI.

Type what you want in plain English. Pi Card understands whether to interrupt, redirect, follow up, or save it for later.

Install after release

Once the v0.1.0 GitHub release exists, install its tagged source:

pi install git:github.com/carbon-ni/[email protected]

npm is a separate publish step. Once @carbon-ni/pi-card is available on npm, install or update it with:

pi install npm:@carbon-ni/pi-card
pi update npm:@carbon-ni/pi-card

To move a Git installation to another release tag, reinstall it with the new tag:

pi install git:github.com/carbon-ni/[email protected]

Try it

From this checkout:

npm install
export TYPESAFE_API_KEY="your-api-key"
pi -e ./src/index.ts

While Pi is working, write what you mean:

| You say | Pi Card treats it as | | --- | --- | | “Actually, use the simpler approach.” | A steer: change direction without stopping. | | “When you finish, summarize what changed.” | A follow-up: wait until the run finishes. | | “Stop this task now. Don't continue.” | A stop: abort, then deliver your message. |

These are examples, not exact phrase rules. If your intent is unclear, Pi Card queues a follow-up rather than interrupting work. It also lets you add examples in your own words. If you tend to send a correction right after the first message, combine them before routing.

Take control when you need to

| Type | What happens while Pi is working | | --- | --- | | **fix the type error | Stop the current run, then send this message. | | &&summarize what changed | Wait until the current run finishes. | | ??is there a simpler way? | Stop and ask Pi to brainstorm before doing more. | | ~~ | Send the last queued && now as a steer, without stopping the run. |

Cards work without an API key. The three message cards run immediately while Pi is idle. ~~ only flips a queued &&; it cannot undo a stop. To force a steer while Pi is active, send && followed by ~~.

More

• Configuration: API key, personal examples, privacy, and diagnostics.
• Development: local checks, routing eval, and extension API.

Without TYPESAFE_API_KEY, plain text keeps Pi's native behavior. With the key, eligible messages and configured examples go to an external service for classification. Check the privacy details before enabling it.