pi-oneliner

Sticky one-line footer for pi coding agent. Optimized for high-signal, zero-wrap workflows.

What you get:

• always-visible session/repo + git branch (dirty/ahead/behind)
• compact right-side status strip from other extensions (ctx.ui.setStatus(...))
• presets: full / compact / ultra (cycleable)
• optional i18n: re-render on pi-i18n locale change

If this helps your daily Pi loop, star the repo → it directly drives maintenance time.

---

Install

Install with Pi, not npm:

pi install npm:pi-oneliner

Then in Pi:

/reload
/oneliner

Project-local install (shared via .pi/settings.json):

pi install -l npm:pi-oneliner

---

Quickstart

• picker UI (recommended): /oneliner
• show current state: /oneliner show
• switch preset: /oneliner full|compact|ultra
• toggle preset cycle: /oneliner toggle
• toggle status strip: /oneliner statuses
• zen mode: /oneliner zen
• self-check: /oneliner doctor

---

Commands

• /oneliner (opens picker UI)
• /oneliner show (or status)
• /oneliner full|compact|ultra
• /oneliner toggle
• /oneliner statuses
• /oneliner zen
• /oneliner doctor
• /oneliner save (or persist)
• /oneliner reload
• /oneliner help

---

Config

Config file:

• ~/.pi/agent/oneliner.json

Fast path:

• /oneliner save writes current preset + toggles
• /oneliner reload reloads config

Common keys:

• preset: "full" | "compact" | "ultra"
• shortCwd: show last 2 cwd segments
• maxSessionLen, maxBranchLen, maxCwdLen: truncation controls
• pollGitMs: refresh git state without running git every render
• modelAliases: explicit alias overrides by provider/id glob

Built-in model aliases cover common families:

• gpt-5.4 → 5.4
• gpt-5.4-mini → 5.4m
• gpt-5.4-codex → 5.4c
• gpt-5.3-codex-spark → 5.3s
• gpt-4o-mini → 4om
• claude-sonnet-4.5 → s4.5
• claude-opus-4.5 → o4.5
• gemini-2.5-pro → g2.5p
• gemini-2.5-flash → g2.5f

User modelAliases still win over built-ins.

Example (status allowlist):

{
  "status": {
    "enabled": true,
    "right": {
      "mode": "allowlist",
      "allow": ["pi-semantic", "govern", "pi-i18n"],
      "priority": ["pi-semantic"],
      "maxVisible": 2
    }
  },
  "modelAliases": {
    "openai-codex/gpt-5.3-codex-spark": "5.3s"
  }
}

---

Files

• config: ~/.pi/agent/oneliner.json

---

For extension authors (how to show up in the footer)

Oneliner does not hardcode other extension keys. If your extension calls ctx.ui.setStatus(key, value), oneliner can render it.

Minimal pattern:

ctx.ui.setStatus("myext", "ok");
// later…
ctx.ui.setStatus("myext", "✕");

Recommendations:

• keep values short (ok, sync, 95%, ✕)
• expose a stable key (don’t include versions)

---

Troubleshooting

• "Package not found"
  • use full name: npm:pi-oneliner
• Installed but /oneliner is unknown
  • run /reload (or restart Pi)
• Footer not showing
  • oneliner only runs when ctx.hasUI is true (Pi TUI)

---

Development

Local dev install:

pi install -l <path-to-pi-oneliner>

Then:

/reload
/oneliner

---

For maintainers

Release checklist:

• update CHANGELOG.md
• bump version: npm version patch (or minor/major)
• npm publish

---

License

MIT