# 🥧 Rhubarb Pi

A collection of extensions for the [pi coding agent](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent).

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Extensions

| Module       | Type        | Install Command          | Config Key        |
|--------------|-------------|--------------------------|-------------------|
| background-notify | hook    | `npm run install:background-notify` | `backgroundNotify` |
| session-emoji | hook       | `npm run install:session-emoji` | `sessionEmoji` |
| session-color | hook       | `npm run install:session-color` | `sessionColor` |
| safe-git     | extension  | `npm run install:safe-git` | `safeGit` |
| pi-agent-scip | extension  | `npm run install:pi-agent-scip` | N/A |

---

### 🔔 background-notify

Get notified when long-running tasks complete while your terminal is in the background. Plays an audio beep and brings the terminal to front (macOS).

**Commands:** `/notify`, `/notify-test`, `/notify-beep`, `/notify-focus`, `/notify-config`, `/notify-status`

```bash
npm run install:background-notify
```

[📖 Documentation](docs/background-notify.md)

---

### 🎨 session-emoji

Display an intelligent emoji in pi's footer that represents your conversation. Uses AI to analyze context and pick a relevant emoji, with 24-hour uniqueness to avoid repetition.

**Commands:** `/emoji`, `/emoji-set`, `/emoji-config`, `/emoji-history`

```bash
npm run install:session-emoji
```

[📖 Documentation](docs/session-emoji.md)

---

### 🌈 session-color

Display a colored band in pi's footer to visually distinguish sessions. Uses a 40-color palette designed for maximum visual distinction between consecutive sessions.

**Commands:** `/color`, `/color-set`, `/color-next`, `/color-config`

```bash
npm run install:session-color
```

[📖 Documentation](docs/session-color.md)

---

### 🔒 safe-git

Require explicit user approval before dangerous git operations. High-risk operations (force push, hard reset) show warnings; medium-risk (push, commit) require confirmation. Blocks entirely in non-interactive mode.

**Commands:** `/safegit`, `/safegit-status`, `/safegit-level`

```bash
npm run install:safe-git
```

[📖 Documentation](docs/safe-git.md)

---

### 🔍 pi-agent-scip

SCIP code intelligence tools for Python and TypeScript/JavaScript projects. Provides fast, compiler-accurate navigation (go to definition, find references, list/search symbols, project tree) using Sourcegraph's SCIP indexers.

**Tools:** `scip_find_definition`, `scip_find_references`, `scip_list_symbols`, `scip_search_symbols`, `scip_project_tree`

```bash
npm run install:pi-agent-scip
```

[📖 Documentation](extensions/pi-agent-scip/README.md)

---

## Quick Start

```bash
# Install everything
npm run install:all

# Or install individually
npm run install:background-notify
npm run install:session-emoji
npm run install:session-color
npm run install:safe-git
```

**Restart pi** after installing for modules to load.

## Documentation & Support

| Topic | Location |
|-------|----------|
| Installation guide | [docs/INSTALL.md](docs/INSTALL.md) |
| Module overview | [docs/SUMMARY.md](docs/SUMMARY.md) |
| Release checklist | [docs/RELEASE.md](docs/RELEASE.md) |
| Troubleshooting tips | [docs/troubleshooting.md](docs/troubleshooting.md) |
| Contributing guide | [CONTRIBUTING.md](CONTRIBUTING.md) |

Have questions or ideas? [Open an issue](https://github.com/qualisero/rhubarb-pi/issues) or submit a PR.

## Testing

```bash
npm run test:e2e       # Run E2E tests (requires pi + tmux)
npm run test:e2e:watch # Watch mode
npm run typecheck      # TypeScript check
```

## Uninstall

```bash
npm run uninstall:all          # Remove everything
npm run uninstall:all-extensions  # Remove all extensions
```

## Requirements

- [pi coding agent](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent) v0.36.0+
- Node.js 20+
- macOS (for background-notify terminal activation)

## License

MIT
# Trigger CI