xl0/pi-lovely-dev-tools

46

stars

88

commits

TypeScript

primary language

Jul 24, 2026

updated

README

@xl0/pi-lovely-dev-tools

Interactive debugging commands for Pi: run tools by hand, inspect the system prompt, and see why the models act stupid.

Demo

Install

pi install npm:@xl0/pi-lovely-dev-tools

Or load without installing:

pi -e npm:@xl0/pi-lovely-dev-tools

Commands

/tool [tool_name] [args...]

Run any tool yourself. The result is displayed for you to review, not sent to the LLM.

  • /tool alone opens a searchable tool selector and a schema-driven argument editor.
  • Positional args map onto the tool's top-level schema properties in order.
  • Partial updates stream while the tool runs; Esc aborts.
  • Inactive tools can still be run manually — active state only gates the agent's own calls.
/tool
/tool read README.md
/tool bash "bun run check"
/tool bash "sleep 30"  # press Esc to abort

Manual runs intentionally bypass tool policy hooks.

/show-sysprompt

Show the rendered system prompt and active tool schemas — useful when the agent isn't behaving the way you expect.

/show-context

Show an estimated token breakdown of the current context — system prompt, context files, skills, tool definitions, messages, thinking, tool calls and results (total and per tool), compactions, and more — plus a coverage map of the files the model has actually seen: startup context files, skills, and read results that survived compaction.

show-context output

/llm-stats

Show one row per LLM call in the current branch: time since the previous agent message, model, what initiated the call, prompt tokens as fresh + cacheR (+ cacheW) = input, output tokens, thinking tokens (when the provider reports them), stop reason, and tool calls. Constrained calls are annotated with [json_schema], [grammar:lark], or [grammar:regex]. The cache-read column is highlighted when cache reads drop from the previous call — a sign you lost your prompt cache.

llm-stats output

Pi Lovely Webweb_search, web_fetch, web_image tools
Pi Lovely CodexGPT fast mode and Codex-style apply_patch tool
Pi Lovely IDEIDE integration
Pi Lovely Configscoped config helpers for Pi extensions
Pi Lovely Commentopen the last assistant message in your editor and sync edits back into the prompt
Pi Lovely Renameautomatic and manual session naming

Like this work? Hire me

Contributors

xl0

86 commits

tmustier

2 commits

xl0/pi-lovely-dev-tools

46

stars

88

commits

TypeScript

primary language

Jul 24, 2026

updated

README

@xl0/pi-lovely-dev-tools

Interactive debugging commands for Pi: run tools by hand, inspect the system prompt, and see why the models act stupid.

Demo

Install

pi install npm:@xl0/pi-lovely-dev-tools

Or load without installing:

pi -e npm:@xl0/pi-lovely-dev-tools

Commands

/tool [tool_name] [args...]

Run any tool yourself. The result is displayed for you to review, not sent to the LLM.

  • /tool alone opens a searchable tool selector and a schema-driven argument editor.
  • Positional args map onto the tool's top-level schema properties in order.
  • Partial updates stream while the tool runs; Esc aborts.
  • Inactive tools can still be run manually — active state only gates the agent's own calls.
/tool
/tool read README.md
/tool bash "bun run check"
/tool bash "sleep 30"  # press Esc to abort

Manual runs intentionally bypass tool policy hooks.

/show-sysprompt

Show the rendered system prompt and active tool schemas — useful when the agent isn't behaving the way you expect.

/show-context

Show an estimated token breakdown of the current context — system prompt, context files, skills, tool definitions, messages, thinking, tool calls and results (total and per tool), compactions, and more — plus a coverage map of the files the model has actually seen: startup context files, skills, and read results that survived compaction.

show-context output

/llm-stats

Show one row per LLM call in the current branch: time since the previous agent message, model, what initiated the call, prompt tokens as fresh + cacheR (+ cacheW) = input, output tokens, thinking tokens (when the provider reports them), stop reason, and tool calls. Constrained calls are annotated with [json_schema], [grammar:lark], or [grammar:regex]. The cache-read column is highlighted when cache reads drop from the previous call — a sign you lost your prompt cache.

llm-stats output

Pi Lovely Webweb_search, web_fetch, web_image tools
Pi Lovely CodexGPT fast mode and Codex-style apply_patch tool
Pi Lovely IDEIDE integration
Pi Lovely Configscoped config helpers for Pi extensions
Pi Lovely Commentopen the last assistant message in your editor and sync edits back into the prompt
Pi Lovely Renameautomatic and manual session naming

Like this work? Hire me

Contributors

xl0

86 commits

tmustier

2 commits

Languages

TypeScript

100.0%