@mrclrchtr/supi-settings

SuPi Settings extension — unified settings command for SuPi extensions via /supi-settings

Packages

Package details

extension

Install @mrclrchtr/supi-settings from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@mrclrchtr/supi-settings
Package
@mrclrchtr/supi-settings
Version
2.2.1
Published
Jul 9, 2026
Downloads
3,213/mo · 1,288/wk
Author
mrclrchtr
License
MIT
Types
extension
Size
136.8 KB
Dependencies
1 dependency · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./src/extension.ts"
  ],
  "image": "https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-settings/assets/logo.png"
}

Security note

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

README

@mrclrchtr/supi-settings

SuPi Settings adds a unified /supi-settings command to the pi coding agent. It gives SuPi extensions one shared TUI for project and global configuration.

Install

pi install npm:@mrclrchtr/supi-settings

For local development:

pi install ./packages/supi-settings

What you get

After install, pi gets one new slash command:

  • /supi-settings — open a searchable settings overlay for registered SuPi extension settings

The overlay groups settings by extension, shows current values with source badges like (project), (global), and (default), and lets you switch between project and global scopes with Tab. Row actions can explicitly set a scoped value or delete it with Inherit / Reset to default.

How it works

supi-settings is the command package for the shared settings registry in @mrclrchtr/supi-core.

Other SuPi extensions register their settings during extension startup. This package renders those registered sections and persists changes back to the appropriate SuPi config scope.

If no installed SuPi extension has registered settings, /supi-settings reports that there are no settings to edit.

Typical settings sections

Depending on which SuPi packages are installed, the overlay may include settings for:

  • supi-lsp — language-server enablement and diagnostics behavior
  • supi-claude-md — subdirectory CLAUDE.md / AGENTS.md discovery
  • supi-bash-timeout — default bash timeout injection
  • supi-cache — prompt-cache monitoring and history collection
  • supi-debug — debug event capture and retention
  • supi-insights — report-generation options

Package surfaces

  • @mrclrchtr/supi-settings/extension — pi extension entrypoint, registers /supi-settings
  • @mrclrchtr/supi-settings/api — public package surface for future settings helpers

Source layout

  • src/extension.ts — pi extension entrypoint
  • src/api.ts — package API surface
  • shared implementation lives in @mrclrchtr/supi-core/settings and @mrclrchtr/supi-core/settings-ui