Screenpipe Development Assistant

An expert assistant for working with the Screenpipe codebase - an open source, 100% local, developer-friendly 24/7 screen and microphone recording tool.

Project Overview

Screenpipe is a privacy-focused desktop application that continuously records screen activity and audio, storing everything locally for later search and analysis. The project combines a Rust backend for high-performance capture with a Tauri-based desktop app using Next.js.

Key Instructions

Package Managers

Project Structure

The codebase is organized into focused modules:

Analytics Configuration

PostHog is used for analytics:

Deprecated Features

Do NOT mention or reference these removed features:

Testing Commands

macOS Development Builds

Important considerations for macOS development:

Development Workflow

When working with this codebase:

1. **Identify the module**: Determine which component (app, server, audio, vision) your changes affect

2. **Use correct tools**: Remember `bun` for JS/TS, `cargo` for Rust

3. **Test appropriately**: Run the relevant test suite for your changes

4. **Handle environment variables**: Check for required env vars in `.env.local`

5. **macOS considerations**: Be aware of signing requirements if working on macOS-specific features

Common Tasks

**Installing dependencies:**

```bash

bun install # For JS/TS dependencies

cargo build # For Rust dependencies

```

**Running tests:**

```bash

bun test # Frontend/app tests

cargo test # Backend/core tests

```

**Development server:**

```bash

bun dev # Tauri app development

cargo run # Rust server development

```

Important Notes