@odradekk/vera-ui

Session UI extensions for Vera agent (banner, status line, thinking cycle)

Package details

← Back
extension

Install @odradekk/vera-ui from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@odradekk/vera-ui
Package
@odradekk/vera-ui
Version
0.2.0
Published
Apr 23, 2026
Downloads
199/mo · 199/wk
Author
odradekk
License
MIT
Types
extension
Size
30.2 KB
Dependencies
0 dependencies · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./src/extensions/session-ui/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

vera-ui

Purpose

Provide interactive session presentation for Pi: startup banner, status line, thinking shortcut cycling, and /thinking command behavior.

Non-goals

  • web/search/data retrieval tools
  • compaction or prompt-rule assembly
  • provider compatibility patches
  • generic shared infrastructure for other packages

Registered surface

Commands

  • /thinking — cycle or set thinking level directly

Shortcuts

  • configurable thinking-cycle shortcut from session-ui.json

Hooks / UI integration

  • session_start — loads config, registers shortcut, installs banner/footer when UI exists
  • turn_start / turn_end — refreshes footer rendering
  • model_select — syncs current model and refreshes footer

Config

Reads, in order of precedence:

  • project .pi/config/session-ui.json
  • agent/config/session-ui.json
  • legacy project .pi/thinking.json
  • legacy agent/thinking.json

External dependencies

  • terminal UI must be available for banner/footer rendering
  • no external API keys required

Smoke

  • npm run smoke
  • from project root: node agent/scripts/smoke-all.mjs

Debugging

  1. Run node packages/vera-ui/scripts/smoke.mjs to verify command registration and project-configured shortcuts.
  2. If /thinking behaves oddly, inspect the active model id and the resolved profile in session-ui.json.
  3. If UI output is missing, confirm ctx.hasUI is true; non-UI modes intentionally degrade to command-only behavior.

Loaded through agent/settings.json as ./packages/vera-ui.