# Pi Projects

> Track and manage projects with git status via dashboard and tool.

- Skill: `espennilsen/pi-projects` (Agent Skill)
- Install (CLI): `npx skillmds@latest add espennilsen/pi-projects`
- Raw SKILL.md: https://api.skillmd.com/api/skills/espennilsen/pi-projects/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: espennilsen (https://skillmd.com/u/espennilsen)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/espennilsen/pi-projects

---


## Pi Projects Extension

Auto-discovers git repos and provides a tracking dashboard.

### Setup

Install the extension, then access:
- Web dashboard at `/projects` via pi-webserver
- `/projects` command for quick status
- `projects` tool for the LLM

### Configuration (settings.json)

```json
{
  "pi-projects": {
    "devDir": "~/Dev",
    "autoScan": true
  }
}
```

- **devDir**: Primary directory to scan for projects (default: ~/Dev)
- **autoScan**: Auto-discover repos on startup

### Tool Actions

- `projects list` — Show all projects with git status
- `projects scan` — Rescan directories
- `projects hide --path /path` — Hide a project from the dashboard
- `projects unhide --path /path` — Restore a hidden project
- `projects sources` — List scan directories
- `projects sources --path /new/dir` — Add a scan directory

### Web Dashboard Features

- Card and table views with search/filter/sort
- Git status: branch, last commit, dirty count, ahead/behind
- Manage modal: add scan directories, hide/show projects

