Skip to content

extensions.md

Latest commit

 

History

History
64 lines (42 loc) · 1.48 KB

extensions.md

File metadata and controls

64 lines (42 loc) · 1.48 KB
Raw
title Pi Extension

Pi Extension

uteke provides a pi coding agent extension that shows memory stats in the footer and reminds the agent to use uteke actively.

Status Bar

Shows memory stats across all namespaces in the pi footer:

🧠 uteke:   🔥 4 hot   🟡 0 warm   ❄️ 63 cold   (67 total)

Auto-refreshes on session start and after each agent turn.

Agent Memory Injection

The extension injects a system prompt that reminds the agent to use uteke:

  • → Save important context proactively (decisions, progress, architecture)
  • → Recall relevant memories before starting tasks
  • → Use namespaces and tags for organization
  • → Save session summaries when ending

Install

  1. Global install (all projects)
cp -r extensions/uteke-status ~/.pi/agent/extensions/
  1. Project-local install
cp -r extensions/uteke-status .pi/extensions/
  1. Reload pi
/reload

Commands

Command Description
/uteke-stats Manually refresh memory stats in status bar

Requirements

  • ✓ uteke installed and in PATH
  • ✓ sqlite3 CLI (pre-installed on macOS and most Linux)
  • ✓ pi coding agent (v0.14+)

How It Works

  • Stats query — Reads ~/.codecora/uteke/uteke.db via sqlite3 CLI for cross-namespace totals
  • System prompt — Injects uteke usage rules via before_agent_start event
  • Status refresh — Updates footer on session_start and turn_end events