@e9n/pi-projects

Project tracking extension for pi — auto-discovers git repos with health status dashboard

Package details

← Back
extensionskill

Install @e9n/pi-projects from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@e9n/pi-projects
Package
@e9n/pi-projects
Version
0.1.1
Published
Apr 26, 2026
Downloads
156/mo · 142/wk
Author
e9n
License
MIT
Types
extension, skill
Size
85.1 KB
Dependencies
1 dependency · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ],
  "skills": [
    "./skills"
  ]
}

Security note

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

README

@e9n/pi-projects

Project tracking dashboard extension for pi. Auto-discovers git repos in ~/Dev, shows live git status, and provides a web dashboard.

Features

  • Auto-discovery — scans a configurable root directory for git repos on session start
  • Git status — branch name, dirty file count, ahead/behind remote
  • Hide/unhide — suppress specific projects from results
  • Multiple sources — scan additional directories via sources action
  • Web dashboard — live project overview at /projects via pi-webserver
  • /projects command — quick status summary in the TUI
  • Bundled skill — includes a git-project-status skill for detailed reports

Setup

Add to ~/.pi/agent/settings.json or .pi/settings.json:

{
  "pi-projects": {
    "devDir": "~/Dev"
  }
}
Key Default Description
devDir "~/Dev" Root directory to scan for git repos
dbPath "projects/projects.db" SQLite path for scan config and hidden projects (relative to agent dir)
useKysely false Use shared pi-kysely DB instead of local SQLite

Tool: projects

Discover and manage git projects on disk.

Actions

Action Description
list List all discovered projects with git status
scan Re-scan the dev directory and refresh project list
hide Hide a project from results (pass id)
unhide Unhide a previously hidden project (pass id)
sources List configured scan source directories

Key Parameters

Parameter Type Description
action string Action to perform (required)
id number Project ID for hide / unhide
query string Filter projects by name (for list)

Commands

Command Description
/projects [search] Show project count, git repos, dirty status — optionally filter by name

Web UI

The dashboard auto-mounts at /projects when pi-webserver is installed, showing live git status for all discovered repos.

Install

pi install npm:@e9n/pi-projects

License

MIT