---
slug: "prowl"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/bangdori/prowl@main/README.md"
repo: "https://github.com/bangdori/prowl"
source_file: "README.md"
branch: "main"
---
<p align="center">
  <img src="assets/prowl-logo.png" width="180" alt="Prowl Logo">
</p>

<h1 align="center">Prowl</h1>

<p align="center">
  <strong>A cat that lives in your background, assisting your tasks from the macOS menubar</strong>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/platform-macOS-black?style=flat-square&logo=apple" alt="macOS">
  <img src="https://img.shields.io/badge/electron-28-47848F?style=flat-square&logo=electron" alt="Electron">
  <img src="https://img.shields.io/badge/react-18-61DAFB?style=flat-square&logo=react" alt="React">
</p>

## What is Prowl?

**Prowl**은 macOS 메뉴바에 상주하는 생산성 앱입니다.

태스크 관리, AI 채팅, 파일 브라우저, AI 메모리를 메뉴바 하나에서 처리합니다.

## ✨ Features

### Prowl Chat

<img width="800" src="demo/prowl-chat-demo.gif" alt="Prowl Chat Demo" style="max-width: 100%;">

ChatGPT OAuth 또는 API Key로 AI 채팅을 사용합니다. 인증 설정은 Settings 탭에서 할 수 있으며, 채팅창 드롭다운에서 모델을 즉시 전환할 수 있습니다.

### Task Manager

<img width="800" src="demo/task-manager.jpg" alt="Task Manager — Compact View and Dashboard" style="max-width: 100%;">

파일 기반 태스크를 날짜·카테고리로 관리합니다.

- **Full View** — 월별 캘린더 그리드에서 태스크를 확인하고 추가·수정·완료 처리합니다. 날짜를 클릭하면 해당 날의 태스크 목록이 펼쳐집니다.
- **Compact View** — 메뉴바에서 바로 꺼내는 스티키 윈도우. 카테고리별·날짜별로 오늘 할 일을 빠르게 훑고 완료 처리할 수 있습니다.

### Personalize

AI 동작 방식을 내 취향으로 조정합니다.

- **Memory** — AI에게 기억시킬 선호·규칙을 영구 저장
- **System Prompt** — 기본 시스템 프롬프트를 직접 편집
- **톤 & 매너** — AI 응답 스타일 설정

## 🚀 Installation

```bash
brew install BangDori/prowl/prowl
```

Homebrew로 설치하면 앱 내에서 자동 업데이트가 지원됩니다.

## Requirements

- macOS 10.15 Catalina 이상